[Grok-dev] Re: [website] Let's do content!

[Noah Gift]

On Jan 2, 2008, at 1:47 PM, Martijn Faassen wrote:

> Hey,
>
> Kevin Teague wrote:
>
>> Re-launching
>> We are getting pretty close to having everything on the new site  
>> equal to or greater than the content on the old site.
>
> This is great! The sooner the better!
>
>> The only big outsanding item is the main Tutorial, I'm going to  
>> take look at having a grok2html script that pushes the content into  
>> PHC next. Maybe also create a custom PHC home page for Grok so that  
>> we can highlight the main Tutorial better as the starting area for  
>> learning Grok.
>
> One important thing about the tutorial is its inline code, which  
> needs to be maintained on the filesystem. For the time being I think  
> we should maintain the whole tutorial on the filesystem (a  
> commenting option would be great though) and push it to the web in  
> as simple a way as we can get away with. I probably already said  
> this before, so sorry if I repeat myself.

There is nothing like getting free help on documentation!  This was a  
brilliant idea for Django, who regardless of your feelings about their  
framework, did documentation at a level that should be aspired to.

http://www.djangobook.com/en/1.0/chapter01/



>
>
> Regards,
>
> Martijn
>
> _______________________________________________
> Grok-dev mailing list
> Grok-dev at zope.org
> http://mail.zope.org/mailman/listinfo/grok-dev