{
  "id": 18419688,
  "title": "A repair manual that has to know what is broken",
  "url": "https://urgent.news/2026/11/06/a-repair-manual-that-has-to-know-what-is-broken",
  "topic": "tech",
  "section": "Tech",
  "published": "2026-11-06T02:07:28.000Z",
  "source": {
    "name": "Dev.to",
    "slug": "dev-to",
    "url": "https://dev.to/devkit/a-repair-manual-that-has-to-know-what-is-broken-39cg"
  },
  "original_language": "en",
  "account": "A repair manual that knows what is broken is designed to guide users through diagnosing and fixing issues without requiring them to identify the problem first. Most home repair attempts fail because individuals misunderstand the root cause of a fault, often purchasing the incorrect part. The goal of this manual is to bridge the gap between symptoms and necessary parts, streamlining the process without relying on expert technicians.\n\nEach guide begins with an animated diagram of the user's existing appliance, such as a faucet, toilet, or drain. These moving parts serve as the explanation for the issue. Unlike static images, which offer little insight into the underlying mechanisms, the animated diagrams illustrate the failure directly, allowing users to understand the problem without reading any text.\n\nUnlike videos, which are heavy, unsearchable, and unpausable, the animated diagrams move along with the user as they progress through the repair process. This integration ensures that the explanation and the step are seamlessly connected, rather than being separate elements. The diagnosis is structured as a decision tree, with two or three key questions guiding the user toward the correct part. The answers to these questions are not form submissions but rather local state that narrows down the decision-making process. This data-driven approach ensures that the diagnosis remains practical and user-friendly.\n\nThe diagnosis process is finite and compact, with each leaf in the decision tree pointing to a tangible part that the user can identify and replace. This client-side design means that the entire manual functions offline once loaded, eliminating the need for server-side decisions and providing a seamless experience without analytics tracking. Before the actual walkthrough, users can practice selecting the right actions through a practice round that assesses their understanding without hints. This practice phase is crucial, as it prevents users from losing track of components during the actual repair, a common occurrence in traditional repair guides.\n\nThe manual is available in four languages—English, Chinese, French, and Spanish—tailored specifically to the terminology used in each market. Literal translations of technical terms often result in unusable or nonsensical instructions in the target language. By having guides written per language, the manual covers common faults rather than an exhaustive encyclopedia, balancing depth and practicality.\n\nThe platform does not include features such as accounts, saved histories, or personalized dashboards. It runs entirely in the browser without storing any data, which may limit its utility for individuals managing multiple properties. However, this limitation is intentional, as it avoids the need for a login barrier that could deter users seeking immediate assistance. The manual explicitly states its limitations in addressing complex issues related to gas, electrical systems, or structural repairs, ensuring that users understand its scope and capabilities. For those interested in exploring the integration of diagnosis and animation, the faucet guide serves as an exemplary resource within the broader platform.",
  "summary": "A repair manual that has to know what is broken Most \"how to fix X\" content is a list of steps. It assumes you already know what the fault is. That assumption is where most home repairs actually fail: someone watches a video about replacing a fill valve when the real problem is the flapper, and buys the wrong part. So the design question I started from was not \"how do I write instructions\" but…",
  "key_points": [
    "Animated diagrams guide users through appliance repair processes",
    "Diagnosis structured as decision tree with key questions",
    "Available in English, Chinese, French, and Spanish"
  ],
  "editors_take": "Replacing static text with interactive animated diagrams and decision trees empowers non-experts to bypass the common mistake of purchasing incorrect parts during home repair attempts.",
  "illustration": null,
  "coverage": {
    "outlets": 1,
    "also_reported_by": []
  },
  "ai_generated": true,
  "disclaimer": "Summaries, key points and the editor’s take are written by software from other outlets’ reporting and may contain errors — always check the linked original."
}