[docs] Documentation for Signature, Parameter and signature in inspect module (issue 15151)

yselivanov.ml at gmail.com yselivanov.ml at gmail.com
Thu Aug 9 13:44:00 CEST 2012


http://bugs.python.org/review/15151/diff/5438/Doc/library/inspect.rst
File Doc/library/inspect.rst (right):
http://bugs.python.org/review/15151/diff/5438/Doc/library/inspect.rst#newcode432
Doc/library/inspect.rst:432: provide no metadata about their arguments.
On 2012年08月08日 21:14:48, asvetlov wrote:
> maybe "metadata for their arguments"?

"about" is better.
http://bugs.python.org/review/15151/diff/5438/Doc/library/inspect.rst#newcode442
Doc/library/inspect.rst:442: a modified copy
On 2012年08月08日 21:14:48, asvetlov wrote:
> put dot at end

agree
http://bugs.python.org/review/15151/diff/5438/Doc/library/inspect.rst#newcode547
Doc/library/inspect.rst:547: **Example**
On 2012年08月08日 21:14:48, asvetlov wrote:
> Just remove this line. Bold looks ugly from my perspective

well, there needs to be some kind of header.
http://bugs.python.org/review/15151/diff/5438/Doc/library/inspect.rst#newcode607
Doc/library/inspect.rst:607: >>> def foo(a, b=10):
On 2012年08月08日 21:14:48, asvetlov wrote:
> Deindent example to avoid gray border around. Not sure.

I actually like how grey borders separate examples from other content. 
Makes it easier to read
http://bugs.python.org/review/15151/


More information about the docs mailing list

AltStyle によって変換されたページ (->オリジナル) /