This page covers a variety of developer documentation products, including the Open edX Developer's Guide, IDA documentation, and other forms of documentation.
Documentation for developers presents an opportunity for edX and the Open Source community. Currently, documentation is scattered across a number of repos, wiki pages, GitHub, and other sources.
See also /wiki/spaces/ArchiveEng/pages/159881063 in the /wiki/spaces/ArchiveEng/pages/159324884 wiki.
Open edX Developer's Guide
Source files: edx/documentation/en-us/developers
The documentation team has not regularly maintained the Open edX Developer's Guide. Most of the content for this guide was created by Dave Ormsbee (Do Not Use) (Deactivated).
The process for creating or updating documentation in this guide is the process outlined on the Creating and Updating Documentation - RTD page.
EdX has a number of independently deployable applications (IDAs), each with its own documentation that is located in the same repo as the IDA. The ECOM team and docs team have discussed the best location for IDA documentation—should documentation for an IDA be with the code, or should it be in the edx-documentation repo?—but have not come to a definitive conclusion. For information about these discussions, see the following pages.
IDA Documentation Strategy 1
IDA Documentation Strategy 2
Open edX Release Notes
Release notes accompany each release version of Open edX. These release notes contain a list of the major updates in the release. For more information, see Open edX Release Documentation and Versioning.
Open edX XBlock Tutorial
The Open edX XBlock Tutorial seeks to show users how to create an XBlock. For more information, see Open edX XBlock Tutorial.
Open Learning XML Guide
The Open Learning XML Guide provides a reference for Open Learning XML (OLX), edX's version of XML. For more information, see Open Learning XML Guide.
Additional Developer Documentation
Additional developer documentation is located in edX wiki pages, GitHub, and other places. The documentation team had a meeting with members of the ECOM team in August to discuss organizing and consolidating developer documentation.
Meeting about developer documentation organization (23 Aug 2016)
As of October 2016, the most common resources for developer documentation are listed on the following page.
For more information, see the following pages.