[Grok-doc] TASK: Update About Grok to include mention of ZODB.org

[Aroldo Souza-Leite]

Hi Roger,


Roger Erens wrote:
> On Thu, Feb 25, 2010 at 22:42, Aroldo Souza-Leite <asouzaleite at gmx.de> wrote:
>   
>> Hi Sebastian, hi Roger,
>>
>> what I did:
>>
>> a) merge bits of the "grok.zope.org/about/evaluate" text into the top text of
>> "grok.zope.org/about"
>> b) create the "Grok's object database" page in "grok.zope.org/about". This page's text includes a link to "http://www.zodb.org"
>> c) include a link to "zodb.org" in
>> "http://grok.zope.org/about/useful-libraries#id10"
>> d) create the "Learning Grok" page in "grok.zope.org/about", whose text includes a link to the official Grok tutorial. Because the tutorial is mentioned in "grok.zope.org./about/evaluate".
>> e) RETRACT "grok.zope.org/about/evaluate", which is now private.
>>
>>
>> Please comment.
>>
>> Regards,
>>
>> Aroldo.
>>     
>
> You _REALLY_ want to earn that Grokstar, don't you?! Do you like
> blogging so much (http://svn.zope.org/Grokstar/)?
>
>   
I don't get the pun. I can't remember having blogged ever, and I must 
have missed some important piece of information that associates a Grok 
star with the Grokstar blog. I just have a young date this weekend and 
could use a Grok star to show her as the beginnig of a conversation.
> On topic:
> For people who like lists, this solution looks perfect. For people who
> like stories, merging the info into the Evaluate-document would have
> been better.
>   
I think a story is better than a list. To start writing a story, I 
created http://grok.zope.org/about/the-grok-story in pure 
reStructuredText. The-grok-story now contains most of the infos in the 
'list', which makes the present list items http://grok.zope.org/about/ 
redundant. The-grok-story should in my opinion replace most of the items 
in http://grok.zope.org/about. Perhaps only 
http://grok.zope.org/about/download, 
http://grok.zope.org/about/overview-of-namespaces and 
http://grok.zope.org/about/useful-libraries should stay outside the 
the-grok-story page.

So my suggestion is:

a) keep
http://grok.zope.org/about/the-grok-story
http://grok.zope.org/about/overview-of-namespaces
http://grok.zope.org/about/useful-libraries
http://grok.zope.org/about/download

b) DELETE all other sub-items from http://grok.zope.org/about

c) Rewrite http://grok.zope.org/about/the-grok-story
c.1) clean it up from redundancies
c.2) verify links
c.3) reorder the paragraphs
c.4) flatten the text for a more prose-like  and  less list-like  structure

I could work on this, beginning next Monday.

What do you think?

Regards,

Aroldo.