diff options
| author | Jarrod Millman <millman@berkeley.edu> | 2007-10-02 06:17:47 +0000 |
|---|---|---|
| committer | Jarrod Millman <millman@berkeley.edu> | 2007-10-02 06:17:47 +0000 |
| commit | 2aa8f463184dab8ea787cea65b511c9a0fc89f54 (patch) | |
| tree | df310d31f6bb4dda6c5ed8f2e0c9f3512062efa3 /numpy/doc | |
| parent | c7108cb9ab07fc410cc8b2f849cbac1d04f3382c (diff) | |
| download | numpy-2aa8f463184dab8ea787cea65b511c9a0fc89f54.tar.gz | |
more on documentation
Diffstat (limited to 'numpy/doc')
| -rw-r--r-- | numpy/doc/HOWTO_DOCUMENT.txt | 20 |
1 files changed, 17 insertions, 3 deletions
diff --git a/numpy/doc/HOWTO_DOCUMENT.txt b/numpy/doc/HOWTO_DOCUMENT.txt index 85f2e36eb..3690bced7 100644 --- a/numpy/doc/HOWTO_DOCUMENT.txt +++ b/numpy/doc/HOWTO_DOCUMENT.txt @@ -1,11 +1,25 @@ -================================= -A Guide to NumPy/SciPy Docstrings -================================= +==================================== +A Guide to NumPy/SciPy Documentation +==================================== .. Contents:: Overview -------- +In general, we follow the standard Python style conventions as described here: + * `Style Guide for C Code <http://www.python.org/peps/pep-0007.html>`__ + * `Style Guide for Python Code <http://www.python.org/peps/pep-0008.html>`__ + * `Docstring Conventions <http://www.python.org/peps/pep-0257.html>`__ + +Additional PEPs of interest regarding documentation of code: + * Docstring Processing System Framework <http://www.python.org/peps/pep-0256.html>`__ + * Docutils Design Specification <http://www.python.org/peps/pep-0258.html>`__ + +Use a code checker: + * `pylint <http://www.logilab.org/857>`__ + +Docstring Standard +------------------ A documentation string (docstring) is a string that describes a module, function, class, or method definition. The docstring is a special attribute |