Agora Developer Documentation Style Guide

This repo hosts the content for Agora Developer Documentation Style Guide. You can browse the guide on this website, which is built with Sphinx.

Contribute to the guide

To make updates to this guide, follow the instructions in this section.

Prerequisites

• Basic knowledge of Git
• A GitHub account
• A code editing tool, such as Visual Studio Code
• A command line tool

Make updates

The master branch is published to Read the Docs as the latest version. To make updates, do the following:

1. Create a new branch from master and update the Markdown file. Each section of the guide corresponds to a Markdown file in _content.

2. Create a pull request to merge your commits to master.

Open an issue for discussion

Feel free to propose something for discussion by opening an issue.

1. Open the Issues page.
2. Click the New Issue button.
3. Edit the title and comments, and then click Submit new issue.

Build the documentation locally

If you want to view the website locally before pushing your changes to GitHub, follow the instructions below.

1. Install Sphinx.

   $ pip install sphinx

2. Install the following packages for Markdown support.

   $ pip install recommonmark

   $ pip install sphinx_markdown_tables

3. Install the theme.

   $ pip install sphinx_rtd_theme

4. Build the website locally.

   // Navigate to the _content folder on your PC
   $ cd /Users/jie/Agora_style_guide/_content
   // Build the website
   $ make html

If everything goes well, you should see something like this in the command line output:

build succeeded, 1 warning.

The output is in /_content/__build.