https://github.com/GreenSteam/pep257/pull/107 has been merged, but is not yet released on https://pypi.python.org/pypi/pep257
When it is released, and if we can force all our tools to use the new released version...
- we can remove non-informative docstrings from our .setters ,
- we should update the property getter docstring to be less 'get' specific.
tools.LazyRegex.flags and tools.LazyRegex.raw are clear examples of a docstring on .setter which is unnecessary
Page.text is a case where we shouldnt change anything, as the have very important information which is different.
I think Bot.current_page and Bot.site could be improved by merging the docstrings.
api's Request.mime setter docstring could be merged into the getter docstring, but I'm not 100% sure about that one.
threadedhttp 's .data look like it shouldnt be changed.