diff options
| author | Chris McDonough <chrism@agendaless.com> | 2009-12-27 15:32:14 +0000 |
|---|---|---|
| committer | Chris McDonough <chrism@agendaless.com> | 2009-12-27 15:32:14 +0000 |
| commit | e4e3aa3449d3ae390402a9cead205626816a2938 (patch) | |
| tree | cdab3582902124055fedfb3d0320157c983638fe /docs/conventions.rst | |
| parent | 878328bdfc3b5ac832f1728e4a0461e3129cf8d4 (diff) | |
| download | pyramid-e4e3aa3449d3ae390402a9cead205626816a2938.tar.gz pyramid-e4e3aa3449d3ae390402a9cead205626816a2938.tar.bz2 pyramid-e4e3aa3449d3ae390402a9cead205626816a2938.zip | |
Rendering cleanups.
Diffstat (limited to 'docs/conventions.rst')
| -rw-r--r-- | docs/conventions.rst | 30 |
1 files changed, 14 insertions, 16 deletions
diff --git a/docs/conventions.rst b/docs/conventions.rst index 23c0017b6..082037782 100644 --- a/docs/conventions.rst +++ b/docs/conventions.rst @@ -1,8 +1,6 @@ Typographical Conventions ========================= -The following typographical conventions are used within this guide. - Literals, filenames and function arguments are presented using the following style: @@ -18,31 +16,31 @@ related to a topic or concept are presented in the following style: Notes, which represent additional information related to a topic or concept are presented in the following style: -.. note:: + .. note:: - This is a note. + This is a note. -We present Python class names using the following style: +We present Python method names using the following style: - :class:`Python.class.name` + :meth:`Python.method_name` -We present Python method names using the following style: +We present Python class names, module names, attributes and global +variables using the following style: - :meth:`Python.method_name`. + :class:`Python.class.name` -We present Python module names using the following style: +References to glossary terms are presented using the following style: - :mod:`Python.module.name`. + :term:`Repoze` -We present Python attributes and global variables using the following -style: +URLs are presented using the following style: - :data:`Python.attribute`. + `Repoze <http://repoze.org>`_ -References ot glossary terms and other document sections are presented -using the following style: +References to sections and chapters are presented using the following +style: - :term:`Repoze`. + :ref:`traversal_chapter` Python code blocks are presented in the following style: |