Re: [matplotlib-devel] matplotlib user guide

2013-10-31 Thread mark
Thank you all for the thoughts so far I have raised a pull request: https://github.com/matplotlib/matplotlib/pull/2554 To be clear, this is a 'structure only' pull request, I have made no documentation changes as yet. I see this as a part of the process. If we can agree structure we can work on

Re: [matplotlib-devel] matplotlib user guide

2013-10-21 Thread Benjamin Root
On Mon, Oct 21, 2013 at 1:26 PM, Chris Barker wrote: > On Fri, Oct 18, 2013 at 11:56 AM, Benjamin Root wrote: > > > FWIW, I think my "Anatomy of Matplotlib" tutorial I gave at SciPy 2013 > > struck a balance between pyplot and the OO interface. > > Grat, I'll take a look. > > Does the ipynb link

Re: [matplotlib-devel] matplotlib user guide

2013-10-21 Thread Chris Barker
On Fri, Oct 18, 2013 at 11:56 AM, Benjamin Root wrote: > FWIW, I think my "Anatomy of Matplotlib" tutorial I gave at SciPy 2013 > struck a balance between pyplot and the OO interface. Grat, I'll take a look. Does the ipynb linked from the tutorial site have most of the presentation material? A

Re: [matplotlib-devel] matplotlib user guide

2013-10-21 Thread mark
hi matplotlib developers as I previously posted, I have thought about structure and flow of the user guide my fist cut of a change set is viewable here: https://github.com/marqh/matplotlib/compare/userGuideShape it keeps all of the same content as the current user guide but subdivides some secti

Re: [matplotlib-devel] matplotlib user guide

2013-10-18 Thread Benjamin Root
On Fri, Oct 18, 2013 at 2:13 PM, Chris Barker wrote: > On Fri, Oct 4, 2013 at 1:40 PM, Russell E. Owen wrote: > >> Introducing Plotting with Matplotlib > >> > >> Pyplot tutorial > >> Controlling line properties > >> Working with multiple figures and axes > >> Working

Re: [matplotlib-devel] matplotlib user guide

2013-10-18 Thread Chris Barker
On Fri, Oct 4, 2013 at 1:40 PM, Russell E. Owen wrote: >> Introducing Plotting with Matplotlib >> >> Pyplot tutorial >> Controlling line properties >> Working with multiple figures and axes >> Working with text >> Interactive navigation >> Navigation Keyboar

Re: [matplotlib-devel] matplotlib user guide

2013-10-04 Thread Russell E. Owen
In article <20130927140906.3ded3...@metarelate.net>, mark wrote: > Many thanks for the feedback. > > So ,my first cut was to segregate the user guide by topic. Below is > the summary I had in mind for an Introduction for New Users. > > Hopefully this gives a flavour of what I have in mind. >

Re: [matplotlib-devel] matplotlib user guide

2013-09-27 Thread mark
Many thanks for the feedback. So ,my first cut was to segregate the user guide by topic. Below is the summary I had in mind for an Introduction for New Users. Hopefully this gives a flavour of what I have in mind. I will attempt to put this into practice and post again when I have a user guide

Re: [matplotlib-devel] matplotlib user guide

2013-09-25 Thread Eric Firing
On 2013/09/24 10:19 PM, mark wrote: > hi matplotlib developers > > I have been considering the matplotlib user guide structure and it > has occured to me that there are two user guides interleaved here: >1. Introduction for new users >2. Library tour for developers > > I think that this str

Re: [matplotlib-devel] matplotlib user guide

2013-09-25 Thread Michael Droettboom
Thanks for the interest. I agree there's lots that can be done to improve it. You may want to familiarize yourself with MEP10 ( https://github.com/matplotlib/matplotlib/wiki/Mep10) though that mainly deals with docstrings and not the narrative documentation. Perhaps as a starting point, you

Re: [matplotlib-devel] matplotlib user guide

2013-09-25 Thread Phil Elson
For the record, I've spoken to Mark about this face-to-face in the past, and I think he has some great ideas about how the user guide should look. Personally I would agree that the user guide is currently not targeted enough (it takes 3 pages full of text before getting to a simple plt.plot() ) an