[Grok-dev] Grok & the lack of good documentation

[grokomobil]

The main tutorial is indeed easy to understand. Probably even a litle bit too
easy to give you enough knowledge that is needed to go on yourself. The
problem, especially for important topics like widgets and schemas is, that
you get no information about them here. You have to crawl through the Zope
API to get at least an idea what default methods they have, what default
widgets are etc.. At this point, you have already lost beginners before they
even created their first grok.form
It's not possible to leave out everything that deals with zope-stuff if you
want to explain a newbie how to use grok. Referencing to the Zope API is no
excuse here cause there is no real explanation either. 


Martijn Faassen-2 wrote:
> 
> grokomobil wrote:
>> Back to topic:
>> 
>> I think a big problem with the recent documentation is also the fact that
>> a
>> lot of Zope knowledge is required to work with them. In many
>> documentations,
>> it seems like most of the authors explain how things work in grok, but
>> when
>> there is zope specific code in it (like things from the formlib) they try
>> to
>> avoid any explanation for it. The developers of grok stated that you can
>> use
>> grok without knowledge of zope, it seems like this is not 100% possible.
>> Or
>> at least, no one cares when he writes a tutorial or how to for it.
> 
> I hope at least some of the tutorials were helpful to you. I tried to 
> write the main tutorial and the developers notes with the idea in my 
> mind people should be able to understand it without previous knowledge.
> 
> It'd be nice if people would help write such documents and integrate 
> them into the official documentation.
> 
> Regards,
> 
> Martijn
> 
> _______________________________________________
> Grok-dev mailing list
> Grok-dev at zope.org
> https://mail.zope.org/mailman/listinfo/grok-dev
> 
> 

-- 
View this message in context: http://www.nabble.com/Grok---the-lack-of-good-documentation-tp25259107p25348077.html
Sent from the Grok mailing list archive at Nabble.com.