News for hackers. Stuff that matters.
Re:Ask HN: Organizing company knowledge? by andreygrehov on Wednesday April 11, 2018 @01:51PM (#16813606)
Well, maybe documenting everything is good, but what's more important is to make sure that the documentation is properly organized, which is exactly what OP is asking about. I've seen many wikis/confluences with multiple documents per topic, i.e. the author of the second document didn't know that the first one existed at all. In such cases, company wikis get cumbersome as they are polluted with knowledge.

I would say that the culture + making sure your projects and teams are well organized is the key to success. In addition, I'd recommend to follow some protocol when documenting things. This will make both writing and reading a less intense and more predictable task, resulting to a better overall experience.

Re:Ask HN: Organizing company knowledge? by godelmachine on Wednesday April 11, 2018 @02:25PM (#16813931)
Only for the sake of emphasizing your point, I have seen companies go out of business only because they did not follow proper documentation procedures.
Re:Ask HN: Organizing company knowledge? by SeaDude on Wednesday April 11, 2018 @07:43PM (#16816821)
Whats funny, is you must also be careful what you document as it becomes discoverable. Even procedures, especially when they are safety sensitive, involve the public, or anything sorbanes.
Re:Ask HN: Organizing company knowledge? by godelmachine on Thursday April 12, 2018 @01:30AM (#16818262)
That's a nice suggestion, but I don't get what is meant by "sorbanes"? Are you referring to Sarbanes–Oxley Act of 2002?