Joel Nothman

Option to select plot image format

1

For some builders, it may be better to produce plot files in formats other than PNG. It should be possible to request that the system outputs _both_ png and pdf...

Store warnings or other stderr

10

I would appreciate a feature where warnings (or perhaps any stderr output) produced by a gallery script was logged somewhere in an associated file. This would make it easier to...

WIP: Try wrapping section content in html classes

2

Trying to make sections stylable (i.e. putting them in HTML elements with specified classes, like `numpydoc-section` and `numpydoc-{parameters,attributes,...}`) turns out to be quite hard: * wrapping section headings breaks parsing...

Convention for multi-line type specifications

23

Parameter lists allow a specification like: ``` my_param : type specification Description ``` In some cases we at scikit-learn have had long type specifications that overflow into the next line...

Add a class doc (including autosummarised attributes and methods) to example.py

1

currently only a function is exemplified.

Remove Numpy*Domains?

3

From #134: Some tracing tells me that wrap_mangling_directives results in NumpyPythonDomain's directives being used to handle py:class, py:function, etc. I find it hard to believe that that's the intention. Do...

Allow param lists to split on ': ' rather than ' : '

15

It is very easy to mistakenly separate parameter names from their type description by `': '` instead of the correct `' : '`. There are at least 260 instances in...

Wish: link anchors for docstring sections

1

It would be great if each docstring section had its own link anchor (perhaps with corresponding sphinx role, or perhaps just a `ref` for simplicity), and even better if each...

Either rotating them or moving them to avoid clashes