diff options
| author | Ian Joseph Wilson <ianjosephwilson@gmail.com> | 2012-06-17 10:34:48 -0700 |
|---|---|---|
| committer | Ian Joseph Wilson <ianjosephwilson@gmail.com> | 2012-06-17 10:34:48 -0700 |
| commit | 2e1d2009f3abe8163e9e2adc5ff5c0bbeb1b4630 (patch) | |
| tree | 48244d0278a25f145e9d5e0f00703836a0492059 /HACKING.txt | |
| parent | cf46a12292cf15303d68d27c6ba4155ecc2b4586 (diff) | |
| parent | 3da92290bfaa8b4072019c916e75cd96ebc0f6dc (diff) | |
| download | pyramid-2e1d2009f3abe8163e9e2adc5ff5c0bbeb1b4630.tar.gz pyramid-2e1d2009f3abe8163e9e2adc5ff5c0bbeb1b4630.tar.bz2 pyramid-2e1d2009f3abe8163e9e2adc5ff5c0bbeb1b4630.zip | |
Merge branch 'master' of https://github.com/Pylons/pyramid
Diffstat (limited to 'HACKING.txt')
| -rw-r--r-- | HACKING.txt | 29 |
1 files changed, 17 insertions, 12 deletions
diff --git a/HACKING.txt b/HACKING.txt index 593e89ac1..dd735bf22 100644 --- a/HACKING.txt +++ b/HACKING.txt @@ -113,23 +113,28 @@ Test Coverage ``nose`` and ``coverage`` into your virtualenv, and running ``setup.py nosetests --with-coverage``. -Documentation Coverage ----------------------- +Documentation Coverage and Building HTML Documentation +------------------------------------------------------ -- If you fix a bug, and the bug requires an API or behavior - modification, all documentation in this package which references - that API or behavior must change to reflect the bug fix, ideally in - the same commit that fixes the bug or adds the feature. +If you fix a bug, and the bug requires an API or behavior modification, all +documentation in this package which references that API or behavior must +change to reflect the bug fix, ideally in the same commit that fixes the bug +or adds the feature. -- To build and review docs: +To build and review docs (where ``$yourvenv`` refers to the virtualenv you're +using to develop Pyramid): - 1. Install ``tests_require`` dependencies from Pyramid's setup.py into your - virtualenv. +1. Run ``$yourvenv/bin/python setup.py dev docs``. This will cause Sphinx + and all development requirements to be installed in your virtualenv. - 2. From the ``docs`` directory of the Pyramid checkout run ``make html - SPHINXBUILD=/path/to/your/virtualenv/bin/sphinx-build``. +2. cd to the ``docs`` directory within your Pyramid checkout and execute + ``make clean html SPHINXBUILD=$yourvenv/bin/sphinx-build``. The + ``SPHINXBUILD=...`` hair is there in order to tell it to use the + virtualenv Python, which will have both Sphinx and Pyramid (for API + documentation generation) installed. - 3. Open the _build/html/index.html file to see the resulting rendering. +3. Open the ``docs/_build/html/index.html`` file to see the resulting HTML + rendering. Change Log ---------- |