[Grok-doc] Updating docs to point to Distribute and how-to build the official Grok docs?
sebastian at urbantalk.se
Fri Apr 29 03:40:57 EDT 2011
I only know how the community docs work.
We've had a couple of guys starting out with Grok over the past year but setting up the environment hasn't been any problems (Ubuntu and Mac OS X). Other than that it's all a black box to me. Is he working on Windows?
29 apr 2011 kl. 00.40 skrev Kevin Teague:
> I've been training a new person on Grok recently, and they got stuck with the "install Setuptools" step, because the Setuptools install process is a bit ... fuddly. I figured since Distribute is more actively maintained and has clearer install instructions, I'd update the Grok Tutorial to refer to Distribute over Setuptools. But it's been a while since I've worked on Grok docs, and I guess the way to generate the Sphinx docs has changed?
> I discovered documentation.cfg and ran "./bin/buildout -c documentation.cfg" to generate ./bin/generate_documentation but this generates documentation that lacks the Grok theme and the Tutorial isn't there ...
> Can anyone tell me how to create these docs correctly? Bonus points if the Grok README.txt which contains out-dated documentation generation instructions is updated.
> Oh, unless of course there are reasons why Grok still points to Setuptools vs Distribute beyond no one has gotten around to updating those docs yet ...
> grok-doc mailing list
> grok-doc at zope.org
More information about the grok-doc