Documentation for Signature, Parameter and signature in inspect module

[asvetlov]

docs review

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.
maybe "metadata for their arguments"?

http://bugs.python.org/review/15151/diff/5438/Doc/library/inspect.rst#newcode442
Doc/library/inspect.rst:442: a modified copy
put dot at end

http://bugs.python.org/review/15151/diff/5438/Doc/library/inspect.rst#newcode547
Doc/library/inspect.rst:547: **Example**
Just remove this line. Bold looks ugly from my perspective

http://bugs.python.org/review/15151/diff/5438/Doc/library/inspect.rst#newcode607
Doc/library/inspect.rst:607: >>> def foo(a, b=10):
Deindent example to avoid gray border around. Not sure.

[yselivanov]

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