Versions Compared

Key

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

Documentation Contributor Guide

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 on docs.oran-osc.org. The ORAN-OSC wiki and other web sites can reference these rendered documents directly, allowing projects to easily maintain current release documentation.

Table of Contents

Tools for Creating Documentation in RST

Editing Tools

Ubuntu

  1. ReText: Ubuntu Software Store or follow the instructions on the project’s Github page; ReText has a live preview feature
  2. Atom with the RST-Preview Package
  3. Notepadqq
  4. gedit

All Platforms

  1. ReST Editor for Eclipse

  2. Visual Studio Code with the vscode-restructuredtext extension

VIM

reStructuredText syntax highlighting mode

VST (Vim reStructuredText) plugin for Vim7 with folding.

VOoM plugin for Vim that emulates two-pane outliner with support for reStructuredText (since version 4.0b2).

Riv: Take notes in rst Vim plugin to take notes in reStructured text.

  1. Emacs with rst-mode turned on

  2. PyCharm

  3. Atom with RST plugins

Web-based Editors

  1. NoTex - it can handle complete projects. You can upload your files and edit stuff.
  2. Online reStructuredText Editor - It does not support all reST constructs (like the .. codeblock:: directive),

Screen Capture and Edit

Ubuntu

Shutter: Ubuntu Software Store or from PPA instructions on the project’s websiteMac

Mac

Greenshot: Mac App Store ($1.99)

1.2.3. Windows

Greenshot (free)

Tip
titleWelcome to your new space!

Confluence spaces are great for sharing content and news with your team. This is your home page. Right now it shows recent space activity, but you can customize this page in any way you like.

Complete these tasks to get started

  •  Edit this home page - Click Edit in the top right of this screen to customize your Space home page
  •  Create your first page - Click the Create button in the header to get started
  •  Brand your Space - Click Configure Sidebar in the left panel to update space details and logo
  •  Set permissions - Click Space Tools in the left sidebar to update permissions and give others access

 

Recent space activity

Recently Updated
typespage, comment, blogpost
max5
hideHeadingtrue
themesocial

Space contributors

Contributors
modelist
scopedescendants
limit5
showLastTimetrue
orderupdate