openstack/devstack
Code Issues Proposed changes

Merge "Update docs section for new build"

Browse Source
This commit is contained in:
Jenkins 2014-10-27 21:18:39 +00:00 committed by Gerrit Code Review
commit eab94dbc2a
1 changed files with 11 additions and 10 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

21
HACKING.rst
View File

@ -126,14 +126,9 @@ and can stay in the project file.
Documentation Documentation
------------- -------------
The official DevStack repo on GitHub does not include a gh-pages branch that The DevStack repo now contains all of the static pages of devstack.org in
GitHub uses to create static web sites. That branch is maintained in the the ``doc/source`` directory. The OpenStack CI system rebuilds the docs after every
`CloudBuilders DevStack repo`__ mirror that supports the commit and updates devstack.org (now a redirect to docs.openstack.org/developer/devstack).
http://devstack.org site. This is the primary DevStack
documentation along with the DevStack scripts themselves.
__ repo_
.. _repo: https://github.com/cloudbuilders/devstack
All of the scripts are processed with shocco_ to render them with the comments All of the scripts are processed with shocco_ to render them with the comments
as text describing the script below. For this reason we tend to be a little as text describing the script below. For this reason we tend to be a little
@ -144,6 +139,8 @@ uses Markdown headers to divide the script into logical sections.
.. _shocco: https://github.com/dtroyer/shocco/tree/rst_support .. _shocco: https://github.com/dtroyer/shocco/tree/rst_support
The script used to drive <code>shocco</code> is <code>tools/build_docs.sh</code>. The script used to drive <code>shocco</code> is <code>tools/build_docs.sh</code>.
The complete docs build is also handled with <code>tox -edocs</code> per the
OpenStack project standard.
Exercises Exercises
@ -235,8 +232,12 @@ DevStack defines a bash set of best practices for maintaining large
collections of bash scripts. These should be considered as part of the collections of bash scripts. These should be considered as part of the
review process. review process.
We have a preliminary enforcing script for this called bash8 (only a DevStack uses the bashate_ style checker
small number of these rules are enforced). to enforce basic guidelines, similar to pep8 and flake8 tools for Python. The
list below is not complete for what bashate checks, nor is it all checked
by bashate. So many lines of code, so little time.
.. _bashate: https://pypi.python.org/pypi/bashate
Whitespace Rules Whitespace Rules
---------------- ----------------