[Grok-dev] Increasing Grok/Zope adoption

[Jan-Wijbrand Kolman]

On 10/11/2011 16:33 , Sebastian Ware wrote:
> 10 nov 2011 kl. 15.34 skrev Mohd Izhar Firdaus Ismail:
>
>> yeah .. if its just a sphinx site, why not readthedocs.org ? ..
>>
>> however, while i havent seen the sphinx site yet,  pointing users
>> directly to a doc when they visit grok.zope.org is not exactly
>> friendly imho ..
>
> I agree, but I fell that it would be good enough for community docs for the time being. The Official Grok Documentation frontpage is nice enough to serve as frontpage as is and it is already set up properly.
>
> Jan-Jaap: How much work was it to set up the Fanstatic docs on ReadTheDocs?

I'd agree that using Sphinx should principally be enough to document 
Grok and it features. Big big advantage is it means hardly any 
server-setup. The current grok.zope.org server is getting quite old and 
rusty actually.

Another big big advantage is it would be easier to integrate updating 
the website with the release procedure. Something I tried to a little 
bit in the context of the groktoolkit package. Releasing grok is not 
particularly hard or anything, but it involves quite some manual steps 
that are tedious.

Anyway, thanks for picking up this ball!

regards, jw