Contributing Documentation

Documentation is published at http://wymeditor.readthedocs.org/.

WYMeditor’s documentation is written for the Sphinx documentation generator. In order to build the documentation, it must be installed.

Building and Opening the Documentation

Building the documentation is as easy as:

$ grunt docsMake

Opening the documentation in the default browser:

$ grunt docsOpen

Building and opening, in succession, in one command:

$ grunt docs

Documentation Source Files

The source files of the documentation are at docs.

The only exception is the readme file, README.rst, which is at the root of the repository. It is included in the build and serves as about_wymeditor.

The Sphinx configuration file, conf.py, and the Makefile are there, as well.

Version Agnostic Documentation

Version agnostic documentation are pages which do not correspond with any specific release.

For example, API documentation are version specific. Upgrading to v1 is version agnostic.

Version agnostic documentation is most useful at its latest version. Therefore, such documentation pages should at least announce that fact.

Include the following at the top of version agnostic documentation pages:

.. include:: /attention_version_agnostic.txt