Petzold's Rules for Writing a Technical Book
Charles Petzold wrote the Bible (or Necronomicon, take your pick) on Windows programming. He's blogging about the creation of his next book, and has posted these five simple rules for aspiring technical authors:
- Don't even try to compete with the docs.
- Forget about comprehensiveness.
- Write shorter chapters.
- It's all about the code.
- Get the reader involved.
#4 is the only one I'd quibble with---I think how the code was written is as important as its final state---but it's all still excellent advice.