[issue19931] namedtuple docstrings are verbose for no added benefit

Changes by Mark Lawrence : -- assignee: -> docs@python components: +Documentation nosy: +docs@python type: -> enhancement versions: +Python 3.4, Python 3.5 -Python 3.3 ___ Python tracker _

[issue19931] namedtuple docstrings are verbose for no added benefit

Raymond Hettinger added the comment: I don't think we should strip-out all the docstrings because you're unhappy with automatically (mindlessly) generated documentation. What you really need is more control over the documentation tool (the ability to save how much detail you want, particularl

[issue19931] namedtuple docstrings are verbose for no added benefit

New submission from Ned Batchelder: When I make a namedtuple, I get automatic docstrings that use a lot of words to say very little. Sphinx autodoc produces this: ``` class Key Key(scope, user_id, block_scope_id, field_name) __getnewargs__() Return self as a plain tuple. Use

[issue19931] namedtuple docstrings are verbose for no added benefit

Changes by Serhiy Storchaka : -- nosy: +rhettinger ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail