[matplotlib-devel] matplotlib user guide

[mark <ma...@me...>]

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 structure makes it challenging for new users to
benefit from the user guide as much as they could.  

I would like to see the user guide separated into two sections, with
the two different audiences in mind.  I feel this would enable new
users of the library to have a more targeted introduction to some of
the neat features without getting bogged down in details they are
unlikely to need (or comprehend). 

I am very happy to have a go at this and put up a set of suggested
changes but I would value input from the community on this approach and
my category suggestions before I submit a pull request.

many thanks
mark