MMQcsvn6128
Let's presuppose an already-functioning documentation system, and three types of organizational players: the "Outstanding Engineer" (OE), the "Grinding-style Middle Manager" (GMM), and "GMM's middle or junior Engineering staff" (GES).
Imagine the following scenario: OE, a true believer at this point, authors an outstanding and informative technical document as an act of pure goodwill. OE is a busy person, with sweeping responsibilities that are often not completely understood organizationally. However, so far, so good, and different OEs across different areas jump in with articles of their own, often for areas they are not even officially involved in.
Meanwhile, GMM is directing GES to digest and leverage these documents to their fullest extent. Note that neither GMM nor GES could have authored the documents they are leveraging.
The Documenter's Dillema is this-- over time, the occurrence of one or more of the following is completely certain:
1. GMM or GES argue successfully that the LACK of an OE document is "the problem", for whatever "the problem" is that day, and that the solution is to force OE to do something about it.
2. GMM and GES successfully sustain a multi-week, widely CCd email thread that includes OE with the implicit expectation that OE monitor and react quickly to developments on this email thread.
3. GMM or GES argue successfully that because a procedure documented by OE does not work anymore, that this is some type of "external critical blocking item" blamable to OE in a status report of some type.
OE types are not OE types because they are stupid. They quickly understand that none of #1-3 would have occurred if it were not for their initial act of goodwill. Therefore, OE types will entirely cease to contribute out of goodwill, and mostly cease to contribute unless strictly necessary, upon which the contribution will be the minimum possible to minimize the damage.
Unless this is recognized and explicitly corrected for at the very top of the organization implementing and consuming the documentation, The Documenter's Dilemma will appear every single time.