On Thu, 10 May 2012 15:02:20 +1000, Nick Coghlan <ncoghlan at gmail.com> wrote: > So, given the advantages of autodoc, is there a concrete reason why we > can't use it for the documentation of *new* standard library modules? Yes. Our reason is that docstrings should be relatively lightweight, and that the sphinx docs should be the more expansive version of the documentation. Yes, this creates a double-maintenance burden, and the two sometimes slip of of sync. But it is a long-standing rule and will doubtless require considerable bikeshedding if we want to change it :) --David
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4