-
Book Overview & Buying
-
Table Of Contents
Mastering IPython 4.0
By :
"Real programmers don't comment their code. If it was hard to write, it should be hard to understand. Real Programmers don't do documentation. Documentation is for those who can't figure out the listing." | ||
| --Legendary | ||
The days of the hero coder toiling away in the darkness for 36 hours straight to produce the perfect code are drawing to a close. Although that still happens (and is fun to do), at the end of the day, most code is written for other people to use, fix, and extend. In order to do this, people other than the original author need to be able to understand what the code does and how.
These groups fall into three classes, each with its appropriate genre of documentation:
|
Group |
Genre |
|---|---|
|
Users |
User manuals and sales pamphlets |
|
External developers |
Interface definitions, APIs, and docstrings |
|
Maintenance coders |
Inline comments and docstrings |
Documentation required by users is outside the scope of this book. This...