Re:Software engineering is a learning process, working code ...
by erik_seaberg on Monday January 18, 2021 @06:27PM
(#25828014)
A big problem is capturing what your team learned, as semi-structured documentation. Otherwise tribal knowledge fades with time and turnover, and you’re finally left with a system you don’t understand but luckily still works.
[ Parent
| on HN ]
Re:Software engineering is a learning process, working code ...
by hyperpallium2 on Monday January 18, 2021 @07:01PM
(#25828280)
If you're lucky enough to have frequent bugs bam! spaced repetition.
Re:Software engineering is a learning process, working code ...
by pm90 on Tuesday January 19, 2021 @12:44AM
(#25830400)
It has to be something that the team commits to maintaining. IME, often there are a couple of folks in the entire team who contribute with any regularity, or care to update the docs. Its often not an activity that's given credit. When the people who maintained the docs switch teams, there is rot- docs become stale. Because they're stale, other users don't trust them don't update them, just stop using them leading to a vicious cycle where they become totally irrelevant.
Re:Software engineering is a learning process, working code ...
by io_nathan on Tuesday January 19, 2021 @02:01AM
(#25830763)
True, but I would say that if (thats a BIG if) the code is written to reflect the domain (see Domain-Driven Design), then other developers should be able to pick up the main concepts of the domain pretty quickly. Maybe you have some artefacts leftover from some Event Stomring sessions or a User Story Map or an Impact Map,... all these come in handy.