[Twisted-Python] doc bloat

[exarkun at twistedmatrix.com]

On 12:55 am, glyph at twistedmatrix.com wrote:
>
>>On Dec 2, 2014, at 20:05, exarkun at twistedmatrix.com wrote:
>
>>Are there lots of useless docstrings on nested function definitions 
>>purely for the sake of twistedchecker?  Or are there undocumented 
>>nested functions that are actually a little bit difficult to 
>>understand on their own?
>
>twistedchecker does not presently require nested function definitions 
>to have docstrings.  I recently merged a fix to an incongruity where it 
>was requiring this of classes defined within functions: 
><https://github.com/twisted/twistedchecker/commit/4af4e97f99d6e5f683b65272a8dbe7bce2087aa7>. 
>So this one, at least, we can cross off for the future :).

The broader context of this suggestion was that we should inspect the 
codebase to see what policy changes would improve the quality of the 
code/documentation while reducing the effort required to develop and 
maintain it.

It sounds like you have some ideas about such changes already.  Does 
that mean you'd like to suggest them (presumably in the form of issues 
filed against twistedhecker) instead of doing this investigation?

Jean-Paul