History for DocumentationSection
??changed:
-
Documentation Section Page
o Give net.fame to contributors
o Highlight new material
o Feature important material
o Encourage contributions (authoring and feedback)
o Link material at other locations
o Help sort the wheat from the chaff
o Mention other non-doc resources in the Community section (such as
mailing lists, IRC, etc.)
o Emphasize Python and the Python doc resources
Materials
o Zope Books, API references, recipes, articles, how to's,
published books, basic introductions
o Reference Python materials?
o Use Backtalk to generate an FAQ as part of the "manual"?
Books
o Multiple formats and languages
o Read and make comments
o Heavy acknowledgement to authors, editors, and contributors
o Some indication of activity (historical over time)
o Deep table of contents to allow quick navigation
o Prominent display of last updated at each level (book, chapter,
section, etc.)
o Instead of arrows to navigate to the next item, display the
title of the next item
Notes
o Mimic PHP's organization and commenting ability. Backtalk has
some of this.
o Place a higher emphasis on recipes.