[jrumbut]

> 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.