You are not logged in Log in Join
You are here: Home » Resources » Zope.org Site Team » ZopeOrgReorg » DocumentationSection

Log in
Name

Password

 
 

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.