Angelo Borsotti [off-list ref] writes:
Why it is so difficult to convince people to make documentation better?
It is not difficult. The discussion on this list is usually done
via patches, and without one, constant talking is buried in other
noise and often go unnoticed.
There is however an issue about documentation consistency. Do we
use elsewhere ( A | B | C ... ) to denote "You must write one (and
only one) among A, B, C, ..." consistently in the documentation?
An ancient discussion $gmane/72243 might be of interest to kickstart
such a documentation clean-up effort.