This guide describes how to create documentation for the RIC platform. RIC repositories create a variety of content depending on the nature of the project. For example, projects delivering a platform component may have different types of content from a project that creates libraries for a software development kit. The content from each project may be used together as a reference for that project and/or be used in documents are tailored to a specific user audience and task they are performing.
Much of the content in this document is derived from similar documentation processes used in other Linux Foundation Projects including ONAP, OPNFV and Open Daylight.
RIC documentation is stored in git repositories, changes are managed with gerrit reviews, and published documents generated when there is a change in any source used to build the documentation.
Authors create source for documents in reStructured Text (RST) that is and published ondocs.oran-osc.org. The ORAN-OSCwikiand other web sites can reference these rendered documents directly, allowing projects to easily maintain current release documentation.
Tools for Creating Documentation in RST
Editing Tools
Ubuntu
ReText: Ubuntu Software Store or follow the instructions on the project’sGithubpage; ReText has a live preview feature