More on the topic...
Generating detailed summary...
Failed to generate summary. Please try again.
Most teams still treat docs like old-school filing cabinets—nested folders, strict hierarchies, single “right” location. But knowledge doesn’t live that way. A single decision about component accessibility, for example, touches design, engineering, content, support. Dropping that info into one folder means everyone else either misses it or duplicates it. Researchers since the ’90s—see work on Semantic File Systems—have argued we should retrieve info by meaning and attributes, not by drilling down through directories.
AI retrieval tools already ignore folder paths. They surface a design token page because it mentions “colour contrast,” not because it sits under Foundations → Accessibility → Colour. That shift makes clear that folders serve storage, not knowledge. In practice, people search first, skim a couple levels of navigation, then give up and ask a colleague. We need multiple discovery routes—search, tagging, metadata, cross-links, semantic relationships—that reflect real human foraging patterns described by Pirolli and Card.
Obsidian’s graph view shows how ideas overlap by linking and tagging rather than forcing notes into one tree. Accessibility guidelines push the same principle: never rely on just color or shape, always layer cues. Good docs follow that model—clear headings, consistent language, rich metadata and inter-page links. Those same traits help AI retrieve relevant snippets regardless of where they’re stored.
The aim isn’t a deeper folder tree. It’s a connected web of knowledge you can reach from any entry point—browser search, a related-topic link, a tag cloud or an AI prompt. When documentation works that way, humans and machines both spend less time hunting and more time using what they find.
Questions about this article
No questions yet.