Exercise 1: Why Findability Is a Genuinely Separate Problem From Accuracy — Possible Solution ==================================================================== WHAT "QUALITY" HAS MEANT THROUGHOUT THIS COURSE SO FAR ------------------------------ Chapters 1 through 8 built toward a document that's accurate (Chapter 1's own central claim), correctly categorized (Chapter 2), clearly written (Chapter 3), properly structured (Chapter 4), genuinely capturing real knowledge (Chapter 5), safely written (Chapter 6), kept current (Chapter 7), and actually tested (Chapter 8). Every one of those properties describes something about the document's own content and correctness. WHY FINDABILITY DOESN'T FIT INTO THAT SAME CATEGORY ------------------------------ A document can score perfectly on every one of those eight properties - completely accurate, beautifully written, properly tested - and still fail its reader entirely if that reader can't locate it. The problem isn't anything wrong with the document itself; it's that the document and the reader who needs it never actually connect. This is a fundamentally different kind of failure than any of the ones addressed so far, because the document's own internal properties are irrelevant to whether it's ever discovered in the first place. WHY THIS MEANS IT REQUIRES A SEPARATE SET OF SOLUTIONS ------------------------------ None of the previous chapters' own techniques - clearer writing, safer credential handling, more thorough testing - do anything to address a document sitting in an inconsistent location, tagged inconsistently, or lost among duplicate copies. Solving findability requires an entirely different toolkit: naming conventions, tagging, cross- linking, deprecation - none of which improve the document's own content at all. WHY THIS CHAPTER TREATS BOTH FAILURES AS EQUALLY SEVERE ------------------------------ Per this chapter, "a technically excellent document nobody can actually find in the moment they need it fails its own purpose just as completely as a wrong one would." From the reader's own perspective in the moment of need, an unfindable-but-perfect document and a findable- but-wrong document produce the identical practical outcome: no working guidance reaches them when it matters. WHY THIS WORKS AS AN ANSWER ------------------------------ It restates what "quality" has meant across the prior eight chapters, explains why findability doesn't depend on any of those same properties, and explains why the chapter treats an unfindable document as an equally severe failure despite it being a completely different kind of problem.