Possibly because a large number of organisations don't really have a good system for capturing somethings as "messy" as notes.
I'm not big on note taking myself, but when I do, the things I capture is very different from the version I put into the official documentation.
There is a good article: A rational design process, how and why to fake it.[1] Basically how we reach our goal and how we present them are two different things. The personal notes have the details on failures, wrong turns and alternative ideas, the official documentation won't have that.
Confluence search is very good.... At finding stuff in PDFs. Search in Confluence is bonkers. Super easy to locate term, know to only exist in one document, and Confluence will return that one PDF that someone uploaded, which for some reason also have that term. It's odd that the search is so poor at searching Confluence pages, yet so good at searching PDFs.
> Possibly because a large number of organisations don't really have a good system for capturing somethings as "messy" as notes.
To build upon this point, there's a problem that writing docs is a thankless job: those who benefit from it do so silently, whereas those who selflessly shared notes later can find themselves involved in issues they have no involvement.
I'm not big on note taking myself, but when I do, the things I capture is very different from the version I put into the official documentation.
There is a good article: A rational design process, how and why to fake it.[1] Basically how we reach our goal and how we present them are two different things. The personal notes have the details on failures, wrong turns and alternative ideas, the official documentation won't have that.
1) https://www.cs.tufts.edu/~nr/cs257/archive/david-parnas/fake...