Class Outline: How to Document a Python Open Source Project

1. writing a document
   1. mastering reStructuredText
      1. presentation of reStructuredText
      2. distribution of cheatsheet
      3. exercises
   2. writing techniques and tips
      1. presentation of the ten laws, with examples
      2. exercise in binomial
   3. team writing
      1. presentation: bad writer, good designer VS good writer, bad designer
      2. exercise: doc review
2. writing documents in Python
   1. documenting a module
      1. presentation : which module to document, how to split content into docs ?
      2. exercise (on an existing package)
   2. documenting a package
      1. presentation: README.txt and friends
      2. exercise: writing the minimum files, testing with cheesecake
3. using documents for test-driven developement
   1. mastering doctests
      1. presentation: unittests ain't doctests
      2. exercise: spliting tests between doctests and unittests
   2. continuous documentation
      1. presentation: designing through doctests
      2. exercise: creating a module with its doctest

BREAK

1. writing documents in a Python Project
   1. writing tutorials
      1. presentation: what's a tutorial
      2. presentation: how to write a tutorial
      3. exercice: write a mini-tutorial
   2. writing cookbook and recipes
      1. presentation: what's a cookbook
      2. presentation: how to write a recipe
      3. exercice: write a recipe
   3. writing a project glossary
      1. exercise: write a glossary
   4. crosslinking everything
      1. exercice: link the recipe, tutorial and glossary
2. website autogeneration with pycommunity
   1. presentation: pycommunity
   2. exercise: setting up a subversion structure
   3. exercise: setting up a hook for website autogeneration
   4. customize pycommunity for an existing website
3. conclusions