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

[Sebastian Ware]

You have a valid point. And part of this has to do with efforts being  
done on the framework in preparation for the 1.0 release. Once things  
start to settle, more and current documentation will emerge.

Another reason for this lack of coordinated documentation is that  
there is no editor in charge of organising the docs.

Our grok-doc effort will hopefully add some momentum to the docs  
department. There is activity going on.

Check this book out, it might be what you need:

   http://www.packtpub.com/grok-1-0-web-development/book

Mvh Sebastian

On 3 sep 2009, at 17.18, 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.
>
>
> Sebastian Ware wrote:
>>
>> I haven't tried any, I found KomdoIDE to be cheap enough (295USD) and
>> the return on investment was probably less than a week (=my first
>> serious debugging session). That said, I am sure there are opensource
>> IDE's that could do the job. I just haven't had any reason to try  
>> them
>> out.
>>
>> Mvh Sebastian
>>
>> On 3 sep 2009, at 15.55, David Bain wrote:
>>
>>> @Sebastian,
>>> Is there an open source IDE that you would recommend as a second
>>> choice?
>>>
>>> On Thu, Sep 3, 2009 at 8:37 AM, Sebastian Ware
>>> <sebastian at urbantalk.se> wrote:
>>> I have added a link to that post to the page:
>>>
>>>
>>> http://grok.zope.org/documentation/tutorial/contribute-to-the-grok-documentation
>>>
>>> If someone objects, feel free to remove it.
>>>
>>> Mvh Sebastian
>>>
>>>
>>> On 3 sep 2009, at 10.12, Jean Daniel wrote:
>>>
>>>>> https://mail.zope.org/pipermail/grok-doc/2009-July/000002.html
>>>>
>>>> Valuable link which would get more visibility when mentionned  
>>>> either
>>>> on
>>>> - the grok.zope.org/community page
>>>> - on this mailing list
>>>> - on the grok.zope.org/documentation/tutorial/contribute-to-the-
>>> grok-
>>>> documentation..
>>>>
>>>>
>>>> thanks for your work, cheers,
>>>
>>> _______________________________________________
>>> Grok-dev mailing list
>>> Grok-dev at zope.org
>>> https://mail.zope.org/mailman/listinfo/grok-dev
>>>
>>>
>>>
>>> -- 
>>> SplashStart - Professional Websites. Starting Now.
>>> http://www.splashstart.com
>>>
>>
>> _______________________________________________
>> 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-tp25259107p25278251.html
> Sent from the Grok mailing list archive at Nabble.com.
>
> _______________________________________________
> Grok-dev mailing list
> Grok-dev at zope.org
> https://mail.zope.org/mailman/listinfo/grok-dev