[Grok-dev] Grok site: changing "Learn" to "Documentation" in the
sebastian at urbantalk.se
Wed Jan 2 19:41:09 EST 2008
3 jan 2008 kl. 00.06 skrev Kevin Teague:
> Luciano Ramalho-2 wrote:
>> I like the word Learn as an invitation for action in the iconic menu
>> on the front page, but in the site "Grok Navigator" portlet I believe
>> "Documentation" would be more appropriate, as that is one of the
>> words we look for when studying a new system.
> Documentation is likely to be more easily understood I think be people
> looking for ... documentation. Although I do like the symmetry of
> verbs for the four main site sections. If we changed all of the main
> sections in the navigator to nouns we would have:
The general idea was to have verbs in the shortcuts (big yellow box on
front page) and nouns in the "tag soup" which in the Plone
implentation has been substituted by section names.
The design idea: The shortcuts address what the visitor wants to
accomplish but aren't familiar with the content of the site. The "Grok
Navigator" is intended for those who now exactly what content they are
looking for. I can't find the design notes I wrote right now, but it
is all explained there, I think they were uploaded on the open plans
website/wiki, but I am not 100% sure.
I think it would be a good idea to read those notes so we don't
reinvent the wheel on this one. (Maybe some of the original ideas are
difficut to implement in Plone. I have understood that configuring a
Plone site isn't a walk in the park.)
> * Evaluate -> About
> * Learn -> Documentation
> * Develop -> Project (?)
> * Participate -> Community
What happened to "Download"?
> I think we have clear organization for what goes into the About/
> Documentation/Learn and Community/Participate sections. The Develop
> is a bit fuzzy, we currrently have on the home page:
> "Develop great applications with Grok. API docs, patterns, forums,
> 'API docs and patterns' are in the documentation section, 'forums and
> mailing lists' are in the community section. What we don't have is a
> space for Grok where we put things such as Release notes and Upgrade
> instructions. Develop is ambigous in that it can mean either
> "develop your
> own applications" or "develop Grok itself".
In the original design there was a "Download" shortcut which seems to
have been omitted. This stuff was intended to be covered there.
> We have the option to use Plone Software Center to structure Grok
> release content, but I'm not sure how well this will fit with the
> Grok release and development process - plus it would mean doing more
> CSS and
> other integration work, so for at least the short term I'd like to
> effort on the Documentation section.
More information about the Grok-dev