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

Aroldo Souza-Leite asouzaleite at gmx.de
Fri Feb 26 06:31:21 EST 2010

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/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

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?



More information about the grok-doc mailing list