[Tutor] Advice required: Documentation Writing / Sofware Testing

[Scot Stevenson]

Hello Terry, 

> (This is, by the way, my major complaint about the O'Reilley "Programming
> Python" text.  I go to Chapter 6 to understand functions in Python, and
> the author makes me understand about packing first.  I don't care about
> packing.  I care about functions.)

Just in case somebody from O'Reilley is hanging around here, I would like to 
second that - in fact, it is worse because Mark Lutz will define an object 
somewhere, and then dozens of pages later will use it in an example (the 
"quit" object comes to mind). Which means that if you are trying to look up 
something, you have to go all the way back to figure out just what he was 
talking about again.

If you're writing technical documentation: Please don't do that. 

Y, Scot

-- 
  Scot W. Stevenson -- scot@possum.in-berlin.de -- Zepernick, Germany