Re: Drafting the documentation page

Dylan Jay <dylan-Q+/Sk2sTzaxWk0Htik3J/[email protected]>
Newsgroups gmane.comp.web.zope.plone.documentation
Message-ID <[email protected]>
On 31/10/2010, at 4:04 AM, Israel Saeta Pérez wrote:

> Hey,
>
> Nicolas Vasseur has been working on a cleaner plone.org/documentation
> page. Please check:
>
> http://plone.org/documentation/helpcenter_ploneorg2
>
> and tell us what you think. We want something clean and simple,  
> pointing
> to our best manuals, as agreed before, and with links to other  
> sections
> like the KB, error reference, faqs...
>
> Any comments appreciated!

very much clearer.

One thing that perhaps could be made more clearer is that the "find  
documentation by topic" on the side bar.

For instance if I click on "Installation" I get http://plone.org/documentation/phc_topic_area?topic=Installation
which has the "Installing Plone" manual 3rd down the list. It does'nt  
really show that the manual is our "best effort" quality documentation  
and the others are user submitted.

I'm not well versed on the cababilities of PHC but just off the top of  
my head are the following possible?

- For each Topic on the side bar have "Manual" as first subtopic and  
have the manual underneath it?

or

- For each subtopic under a topic, e.g. Linux under Installation, have  
the first link be a to the appropriate chapter of the manual?

other ideas?

or are we just better off spending more time merging the kb items into  
manuals or removing them?




>
> -- israel
>
>
> ------------------------------------------------------------------------------
> Nokia and AT&T present the 2010 Calling All Innovators-North America  
> contest
> Create new apps & games for the Nokia N8 for consumers in  U.S. and  
> Canada
> $10 million total in prizes - $4M cash, 500 devices, nearly $6M in  
> marketing
> Develop with Nokia Qt SDK, Web Runtime, or Java and Publish to Ovi  
> Store
> http://p.sf.net/sfu/nokia-dev2dev
> _______________________________________________
> Plone-docs mailing list
> [email protected]
> https://lists.sourceforge.net/lists/listinfo/plone-docs


------------------------------------------------------------------------------
Increase Visibility of Your 3D Game App & Earn a Chance To Win $500!
Tap into the largest installed PC base & get more eyes on your game by
optimizing for Intel(R) Graphics Technology. Get started today with the
Intel(R) Software Partner Program. Five $500 cash prizes are up for grabs.
http://p.sf.net/sfu/intelisp-dev2dev
lmpx.com only provides a reader for public news (NNTP) servers. It is not affiliated with the servers or forums shown here and is not responsible for the content of articles, which is written by their respective authors.