Introduction
This document describes a proposed project to re-organize the official documentation of Evergreen. It is intended to spark discussion at a meeting on February 10, 2016.
Methodology
I compiled a list of mentions of this project by searching in IRC and mailing list logs. I then categorized these into values, goals, and ideas on this wiki page.
I then created at least one concrete requirement based on each goal.
Conventions for this document
Ideas expressed about this project
Values
Goals
Ideas
Requirements
Structure requirements
The current documentation must be re-arranged into separate books, each of which must present content in its own specific order.
The exact same content must be present in multiple books without needing to be updated separately (e.g. a chapter about the Evergreen community, or an introduction to the client interface)
The
HTML version needs to have crosslinks between related content in other books.
End-user interface requirements
PDF generation
Search
Manageability and maintainability
We need to have specific people assigned to re-organizing content and writing any new content that is needed. These should preferably not be current DIG members, so that the demands of documenting new features don't interfere with the completion of this project.
The documentation needs to be split into small chunks for easier maintainability.
Testing
We need a separate server for the re-organized docs so that we can test our docs on end users without interrupting access to the current documentation.
We need to identify a group of beta testers for each book that will test out each book in their day-to-day operations.
Proposed timeline