[Grok-dev] finishing reference docs

Kevin Teague kevin at bud.ca
Mon Sep 22 19:23:21 EDT 2008


To work on the docs:

 1. Check out grok from trunk.
 2. Bootstrap and run ./bin/buildout. This will install the Sphinx 0.4
egg and create a ./bin/grokdocs2html script.
 3. Run ./bin/grokdocs2html. This will read the ./doc/ ReST files as
input and output ./build/html/ files.
 4. Modify ./doc/ files. Re-run grokdocs2html. Preview work.
 5. Commit to svn.

I'm dusting off my "grok documentor" hat, and am going to start
working on these items right now:

> components
> ----------
> grok.Application
> grok.Model
> grok.Indexes
> grok.PageTemplate
> grok.PageTemplateFile
> grok.*Form
>

Aside from the Reference docs, there are a few XXX spots I think in
the tutorial and other places that could use a little proofreading and
editing.


More information about the Grok-dev mailing list