python documentation example

[cekees]

provide relatively complete documentation for a module that demonstrates a decent set of features of ReST with Sphinx extensions.

[adimako]

@cekees @tridelat same as previous