Hi Roger,
Roger Erens wrote: > On Thu, Feb 25, 2010 at 22:42, Aroldo Souza-Leite <[email protected]> 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. _______________________________________________ grok-doc mailing list [email protected] https://mail.zope.org/mailman/listinfo/grok-doc
