Contributions to this documentation are welcome. Documentation is written in reStructured Text (rST). A quick rST reference can be found here. Builds are powered by Sphinx and are hosted by ReadTheDocs.
First, fork the OSFDocs repo, clone it, and install the requirements (requires Python 2.7 or 3.4 with pip):
# After forking jlcohoon/OSFDocs $ git clone https://github.com/<your_github_username>/OSFDocs.git $ cd OSFDocs $ pip install -r requirements.txt
Be sure to replace <your_github_username> with your Github username.
To build docs:
$ invoke docs -b
The -b (for "browse") automatically opens up the docs in your browser after building. Alternatively, you can open up the docs/_build/index.html file manually.
You can use sphinx-autobuild to automatically build the docs when you change a file in the docs directory.
To install sphinx-autobuild:
$ pip install sphinx-autobuild
You can now start the livereload server with:
$ invoke watch
Point your browser to http://localhost:8000 to see your docs.
Once you are done making your edits, send a pull request on Github to the OSFDocs repo.
Use the following underlining conventions for heading levels:
=for h1*for h2-for h3^for h4