Re:Ask HN: How do you keep your codebase knowledge in your t...
by flattenedbybus on Thursday August 01, 2019 @08:31AM
(#20583161)
Good old Word documents work well for this along with comments in the code, which reference these documents.
[ Parent
| on HN ]
Re:Ask HN: How do you keep your codebase knowledge in your t...
by mlejva on Thursday August 01, 2019 @08:53AM
(#20583291)
How often do you write/update such documents in your team?
If you do it the way you described, isn't it hard to search for some specific knowledge?
Re:Ask HN: How do you keep your codebase knowledge in your t...
by flattenedbybus on Thursday August 01, 2019 @09:11AM
(#20583386)
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.