Triggered by this comment I'd like to propose a change on how documentation is created & maintained, resulting in a better experience for how users 'consume' it.
A common issue for any detailed documentation is the limited time the potential readers have, resulting often into TL;DR
How to resolve this dilemma is an open challenge for many projects.
Current situation for OMV is an online manual and a separate (unlinked) repository with PDF documents covering the same topics but from a different angle and different content.
Mozilla Foundation is now trying to address these challenges using a new MDN platform. Details to be found here.
Questions:
- what are the maintainer's views in the changed approach (not the tooling!!)