gunnarhj wrote:
While individuals or teams try to keep certain pages of the wiki up to date, there is currently nobody who is responsible for monitoring/maintaining the contents as a whole.
Yes, this is a significant part of the issue. No one is “at the wheel” driving the docs side of things. Can you imagine the development of the ubuntu operating the way docs operates?
Their currently is no system for contents to go from a bug report/forum/list/irc/whatever into the necessary documentation.
Their is no one looking at the volumes of documentation an propagating and updating/revising that in a systematic way.
All of the places where parts of the docs are created do not have the tooling in place to streamline the documentation process.
Their is no system for ensuring the documentation is updated and relevant to the whole process.
Their is little understanding of the differing classes of documentation
needed to ensure the long-term health of the whole ecosystem.
- Concept documents intended to explain the concepts in simple ways for those new to it
- Tutorials that walk a user though implementing a new concept.
- Tutorials and reference materials for taking a concept a little further
- Tutorials and scripts for actually getting a more focused system up and in place
- Reference materials
The root of the issue comes down to the fact that there is currently nobody who is responsible for monitoring/maintaining the contents as a whole.