Re: [matplotlib-devel] MEP10: Modernize documentation.

2013-01-09 Thread Michael Droettboom
On 01/09/2013 12:20 PM, Nelle Varoquaux wrote: Hi all, A while back, Mike drafted a MEP to modernize the documentation: https://github.com/matplotlib/matplotlib/wiki/Mep10 The main idea behind this MEP is to use the full potential of new tools and conventions available for sphinx, to make the

Re: [matplotlib-devel] MEP10: Modernize documentation.

2013-01-09 Thread Michael Droettboom
On 01/09/2013 12:43 PM, Todd wrote: On Wed, Jan 9, 2013 at 6:20 PM, Nelle Varoquaux mailto:nelle.varoqu...@gmail.com>> wrote: - use the autodoc_docstring_signature of sphinx 1.1, which allow to have the explicit function signature instead of the python one in the generated documenta

Re: [matplotlib-devel] MEP10: Modernize documentation.

2013-01-09 Thread Todd
On Wed, Jan 9, 2013 at 6:20 PM, Nelle Varoquaux wrote: > > - use the autodoc_docstring_signature of sphinx 1.1, which allow to have > the explicit function signature instead of the python one in the generated > documentation (args* and **kwargs are replaced by the explicits arguments) > > If you ha

[matplotlib-devel] MEP10: Modernize documentation.

2013-01-09 Thread Nelle Varoquaux
Hi all, A while back, Mike drafted a MEP to modernize the documentation: https://github.com/matplotlib/matplotlib/wiki/Mep10 The main idea behind this MEP is to use the full potential of new tools and conventions available for sphinx, to make the documentation more readable, maintainable and con