Differences between revisions 10 and 11
|Deletions are marked like this.||Additions are marked like this.|
|Line 3:||Line 3:|
|The NumPy/SciPy *Documentation Marathon 2008* is underway! This page aims to give an overview of our goals and the roadmap for implementing them. NumPy/SciPy is a community project: we need your contributions, so don't be afraid to jump in!||The NumPy/SciPy *Documentation Marathon 2008–* is underway! This page aims to give an overview of our goals and the roadmap for implementing them. NumPy/SciPy is a community project: we need your contributions, so don't be afraid to jump in!|
The NumPy/SciPy Documentation Marathon 2008– is underway! This page aims to give an overview of our goals and the roadmap for implementing them. NumPy/SciPy is a community project: we need your contributions, so don't be afraid to jump in!
- How do I contribute?
- If you're keen to get started right away, go straight to the documentation editor.
Improve the documentation content. This summer's goals:
- A complete, professional reference guide for NumPy
- Reference documentation (aka "docstrings") for all NumPy functions
- Specific topic docs (slicing, broadcasting, etc.)
- Examples ("doctests") in most/all docstrings
- Autogeneration of HTML and PDF for the guide from the sources
An introductory guide to NumPy
Docstrings for many SciPy functions
Implement a framework that allows the broader community to participate in the documentation process.
The NumPy docstrings have been extracted from the latest source code and loaded onto the documentation editor. From here, any member of the community can add, edit, or correct its content. Community technical reviewers will check each docstring for completeness, readability, and technical accuracy before merging changes into the main source tree. The editor is then updated to reflect the latest docstrings.
This year's team:
- Planning, team coordination, funding: Joe Harrington
- Function docs, community coordination, technical support: Stefan van der Walt
- Documentation editor web framework: Pauli Virtanen, Emmanuelle Gouillart
- Non-function docs: Perry Greenfield
- Writing and reviewing: the NumPy community (you!)
- Extract docstrings from source code, using introspection (because some documentation is added programmatically).
- Parse the docstrings into known sections: summary, description, parameters, examples, notes etc.
- Re-generate the docstring using Sphinx-extended ReST.
- Amalgamate the docstrings into a larger document, i.e. the reference guide. (If required, the docstrings can be extended in this document by adding an appropriately named .rst file to the documentation source tree).
Writers should be fluent in English, must write well and grammatically, and should know the functions well enough to serve this role.
- Stefan van der Walt
- Perry Greenfield
Anyone can contribute to review, be it for technical accuracy or accessibility to a newbie. Leave your comments in the section provided underneath each docstring on the documentation editor.
If you are a skilled, (near-) professional copy editor, we'll be doing a final, pre-release proofing of all the docs. Please let us know of your interest and experience.