undefined | Better HN

0 pointsmrweasel0y ago0 comments

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.

1) https://www.cs.tufts.edu/~nr/cs257/archive/david-parnas/fake...

0 comments

3 comments · 2 top-level

XorNot0y ago· 1 in thread

I'd posit a simpler explanation: most large orgs buy Confluence, and you cannot find anything in Confluence.

mrweaselOP0y ago

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.

motorest0y ago

> 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.

It's a lose-lose situation.

j / k navigate · click thread line to collapse