annegentle / www

The main website for Write the Docs.

Write the Docs website

This is the code that powers www.writethedocs.org. It contains information about the Write the Docs group, as well as information about writing documentation.

The repo is still in its early stages; feel free to contribute information that you might want to share with the community. To contribute to the Write the Docs website, famililarize yourself with the Sphinx site generator.

To generate the docs locally:

1. Install python 2.7.x using your package manager.

2. If your version of Python as shown by python -V is <= 2.7.9, download and install pip .

3. In the repository root directory (www by default), as the root user, run pip install -r requirements.txt to install sphinx and other requirements.

4. In the docs directory, run make livehtml to view the docs on http://127.0.0.1:8888/.

The Write the Docs website is hosted on Read the Docs.

Viewing changes on staging

If you you can't run make livehtml locally, or don't want to, you can preview changes by merging them into the staging branch and pushing that to GitHub.

If your feature branch is changes-to-test you would do something like:

git checkout staging
git pull
git merge changes-to-test
git push

Unless there are merge conflicts you need to resolve, when you push those changes a build is triggered on Read the Docs and when it is finished you can preview your changes on:

http://writethedocs-staging.readthedocs.io/en/staging/

Updating the theme or css

If you need to update the theme, the original source is in

https://github.com/writethedocs/website-theme/

and instructions on how to update it are in the README.md