What to put in a python module docstring?

Posted by 007brendan on Stack Overflow See other posts from Stack Overflow or by 007brendan
Published on 2010-03-31T23:04:34Z Indexed on 2010/03/31 23:33 UTC
Read the original article Hit count: 286

Filed under:
|
|

Ok, so I've read both PEP 8 and PEP 257, and I've written lots of docstrings for functions and classes, but I'm a little unsure about what should go in a module docstring. I figured, at a minimum, it should document the functions and classes that the module exports, but I've also seen a few modules that list author names, copyright information, etc. Does anyone have an example of how a good python docstring should be structured?

© Stack Overflow or respective owner

Related posts about python

Related posts about documentation