https://mindflakes.com/tags/documentation/Recent content in Documentation on Nelson Chen's BlogHugo -- gohugo.ioen-usCopyright Nelson ChenSun, 06 Sep 2026 10:34:51 -0700https://mindflakes.com/posts/2026/09/06/comma-repair-answers/Sun, 06 Sep 2026 10:34:51 -0700https://mindflakes.com/posts/2026/09/06/comma-repair-answers/<p>One of the things I keep working on is the <a href="https://github.com/ophwug/docs">unofficial comma hardware documentation</a>. Somebody has a broken device, people help investigate, and eventually there is an answer somewhere in Discord.</p> <p>Then somebody else has the same problem.</p> <p>Discord is an annoying place for the answer to live. Finding the right conversation is work, the useful detail might be several messages away from the original question, and a person searching the web may never find it at all.</p> <p>So I keep trying to get those cases into a public document that search engines and AI assistants can read. Especially AI assistants, because people already ask them how to fix things. I want the actual repair knowledge to be available when somebody asks about their broken comma.</p> <p>That is a big part of why I do it this way. An answer buried in Discord is not much help if the tool somebody is asking cannot get to it. A public document gives it something to find, read, and point back to. It does not guarantee a correct answer, but at least the specific cases and their limitations are there to work from.</p> <h2 id="the-useful-part-is-the-follow-up">The useful part is the follow-up</h2> <p>The document is organized around cases: what the person sees, what might be wrong, and what has helped other people with that particular problem. It has grown quite a bit. I do not expect anybody to sit down and read the whole thing in order.</p> <p>Recent additions and updates include more fuse repair reports, a fastboot-only recovery case, and another cable gotcha. These are the small details that can save somebody a lot of time if they are findable at the right moment.</p> <p>Fuse cases are a good example of why the reports matter. A suspected fault and a confirmed repair are different pieces of information. Somebody coming back with “that fixed it” makes the original discussion much more useful. An unsuccessful repair is worth recording too, especially if the symptoms seemed to fit.</p> <p>The repair work belongs to the community members doing it and reporting their results. My contribution here is collecting the cases, keeping the references, and updating the guidance as more information comes in.</p> <h2 id="similar-looking-problems-need-different-answers">Similar-looking problems need different answers</h2> <p>The fastboot-only case covers a specific recovery situation on the comma three and comma 3X. A device can still show up in fastboot while being unable to enter the EDL mode used by the current flasher. Seeing a USB device on the computer does not establish that the flasher can talk to it in the mode it needs.</p> <p>That distinction needs to stay attached to the recovery notes. Otherwise a workaround for a particular failure starts looking like a general recommendation for everybody.</p> <p>The comma four cable case is another good one. The included OBD-C cable does its intended installation job, but lacks the USB data lines needed for computer flashing. That is a pretty frustrating detail to discover while you are already trying to recover something.</p> <p>Neither case needs a second set of instructions here that will drift out of date. The maintained document has the details and references.</p> <h2 id="constant-little-updates">Constant little updates</h2> <p>This work is mostly incremental. Another symptom, another result, a clearer explanation of which device a case applies to. Sometimes the useful update is just making it harder to confuse two similar situations.</p> <p>I like having a place where those answers can accumulate. Whether somebody finds it through a search engine or asks an AI to help, I want them to end up at the relevant case, with the references and pictures available to check. The answer should have somewhere to point back to.</p> <p>The <a href="https://github.com/ophwug/docs">docs are here</a>. If you try a remedy from them, please report back whether it worked. That follow-up is part of what makes the next version of the document better.</p> <p>I might need these docs myself soon. My own comma 3X did not boot when I tried powering it over USB. I have not figured out why yet, so I may get to find out how useful my own documentation is from the other side.</p>