News for hackers. Stuff that matters.

flattenedbybus

We write and update these documents when needed (this usually means when something has changed in the code) and when knowledge is fresh in people's mind.

If documents are referenced in the code it is straightforward to find them when needed. We also have documents to capture general architecture, which obviously help devs finding their way around the codebase.

Good old Word documents work well for this along with comments in the code, which reference these documents.
Perhaps if it was possible to discuss these topics without being immediately downvoted to hell for expressing an "incorrect" opinion people would not feel they have to create these throwaway accounts.

This is a sign that people are not confident to express views and self-censor. This is a response to a type of bullying.

Perhaps HN could also have a policy on submissions such as this one, which only purpose is political battling.