Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  1. Is our proposal to build a root RTD site as an index for all Open edX-related documentation the best approach for organization/discovery?

  2. Is our proposal to create entry points and pathways by user personas (described below) the best approach to organize the root RTD site?

  3. Is our proposal to use the documentation quadrant approach (described below) the best approach to create and present documentation going forward?

Info

Please feel free to provide your input in the comments, or make in-line comments in the proposal directly. Alternatively, take our quick poll after reading!

...

Summary and Recommendation

Problem

Over the years of its existence, the documentation to support Open edX has grown and evolved organically. Without a clear end-to-end information strategy to guide the creation and organization of the documentation, and without a clear definition of users’ end goals, a number of problems have arisen:

...