Writing Documentation

Note

Contributions to the documentation are much appreciated.

What is used to write the documentation?

This documentation is written in Sphinx, a documentation generator written in Python.

The documentation is written in reStructuredText (reST), a very easy to write plain text format, relatively similar to Markdown.

So see what the source looks like, click the Source link in the footer of this page.

Where is the documentation?

The reST documentation files are located in the converse.js code repository under docs/source.

How to generate HTML from the source files?

Generate the HTML

After installing the dependencies, you can generate the HTML by running:

make html

The HTMl files will be located in ./docs/html

What make html does for you is it installs zc.buildout which is used to install Sphinx and all its dependencies.

You’ll need to have Python and Virtualenv available on your computer.

Warning

When contributing, please don’t commit any generated html files.

Serving the documentation

To view the generated docs, you can run make serve and then open http://localhost:8000/docs/html/index.html in your browser.