Re: Drafting the documentation page
John Schinnerer <john-/Gao9/[email protected]>
| Newsgroups | gmane.comp.web.zope.plone.documentation |
|---|---|
| Message-ID | <[email protected]> |
Aloha, > 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! So far so good overall, I would say. Seems pretty obvious where to go for what, and there's not so much at once that it's overwhelming. The "by topic" sidebar is a good thing to have. And I would suggest put newest stuff first, oldest stuff last in what is displayed via those sidebar links. For example when I click on 'visual design' under 'Customizing Plone' in that sidebar, the second item displayed under "creating theme products" is "Creating a new theme for Plone: a real-world example (Plone 2.1, 2.5)". I suggest it ought to be down at the end of that section with the link to the old DIYPloneStyle 2.x item. In short, list Plone 4 and/or non-version-specific, and then 3.x, and then 2.x. Also, some indication as to what the gold stars next to an item mean. For the main Documentation page a few more words of explanation under the link to "Theme reference" in the getting started section might be helpful to those new to Plone and its' terminology. Something drawn from this perhaps: "A theme is a collection of page templates, style sheets, components, and configuration settings that go to make up the individual look and feel of a Plone site" (the first sentence of "What's a Plone Theme?" page). Thanks for all the great work! cheers, John S. -- John Schinnerer - M.A., Whole Systems Design -------------------------------------------- - Eco-Living - Whole Systems Design Services People - Place - Learning - Integration [email protected] http://eco-living.net ------------------------------------------------------------------------------ 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 _______________________________________________ Plone-docs mailing list [email protected] https://lists.sourceforge.net/lists/listinfo/plone-docs