[Grok-doc] TASK: Update About Grok to include mention of ZODB.org
asouzaleite at gmx.de
Fri Feb 26 06:31:21 EST 2010
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
>> 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
>> 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.
> 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/useful-libraries should stay outside the
So my suggestion is:
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