Documentation Team Handbook Structure Proposal

For a long time our Handbook was almost completely useless for new contributors. It’s half empty and yet full of outdated information. We want to fix this. It won’t be easy and it needs much more than just a content update. It needs complete refactoring. And we need to change our perspective and treat it as one of our ongoing projects.

Refactoring progress is tracked in Trello board. This board is public and you are welcome to join, leave your comments or just follow the progress. Please note that this board is for refactoring purposes. Once we are done with it, it will be back to only team visible and used for documentation team’s work on Handbook. Contributions to the Handbook will be done through docs trac. Or at least we’ll try to use it.

In TrelloTrello Project management system using the concepts of boards and cards to organize tasks in a sane way. This is what the team uses for example: board you can find proposed new structure and proposed changes for each page. Please take a look, think about its usability and how intuitive it is from the new contributor’s perspective and let’s discuss it on one of coming up docs meetings.

Proposed structure:

This marks following pages for removal:

Empty pages:

Unclear pages:

Outdated pages:

Merged to other pages: