The doc team seeks to create useful information for anyone who uses the edX platform—learners, educators, researchers, system admins, and developers. Our documentation is based roughly on audience, with one or more products that correspond to each one. For example, for our course authors audience, we have the Building and Running an edX Course guide.
Because the documentation team's capacity has been limited, ownership and maintenance of some of these products has been transferred to other teams. The documentation team currently maintains documentation for all Learner, Educator, and Business teams, but does not cover any Infrastructure teams, including the Open Source and data teams.
Specifically, the documentation team will continue to update the partner version of our educator and learner guides (Building and Running an edX Course and the EdX Learner's Guide) and any documentation for the business team. The documentation team does not currently maintain the Open edX versions of our educator and learner guides (Building and Running an Open edX Course and the Open EdX Learner's Guide).
If partner, learner, or business documentation needs updates, anyone in the organization—including program coordinators, partner managers, and course author support—can submit a JIRA ticket to the DOC project. The documentation team will prioritize these requests.
Other teams will use the information that the documentation team has provided to maintain their documentation products.
For more information, see Doc Team Work Information.
The owner of a documentation product determines if a feature or change needs documentation, then either creates that documentation independently or requests help from the documentation team.
In general, you can use the following checklist to determine whether a feature or change needs documentation. The page for each product has more information for that specific product.
A doc product owner can update documentation independently or request help from the documentation team.
Creating or updating documentation generally involves creating a new branch from the edx-documentation master branch, finding or creating .rst source files, merging any changes to the master edx-documentation branch, and then building the updated documentation product on readthedocs.
For more information, see Creating and Updating Documentation - RTD.
Note: The edX Help Center is authored in Zendesk. Contact the doc team for updates or inclusions to the help center.
The documentation team is happy to provide limited writing and editing services. When you request help from the team, you can write a draft of the documentation for the doc team to review, or you can provide enough information for the doc team to write the documentation. The documentation team will then prioritize the work.
To ask for help from the doc team, submit a JIRA ticket to the DOC project. Make sure that the ticket includes: