2 ms·
> disconnected from the engineering cycle Great phrase! To me, there are three places that dev-generated documentation can live: 1. The code 2. The issue tr
by jrumbut 3y ago
> disconnected from the engineering cycle
Great phrase!
To me, there are three places that dev-generated documentation can live:
1. The code
2. The issue tracker
3. The version control system
A small amount of exceptionally useful and frequently referred to documentation like the process for setting up a new dev environment or some complex support task can live elsewhere.
Otherwise, I think the top down imposition of a documentation culture is unlikely to succeed.
The real secret to getting a team that has a shared understanding of the system, the business, and each other is to retain your developers. A team that's been together for five years has superpowers no amount of documentation can replicate.