Thread: [matplotlib-devel] Orphaned RST pages

We have a few orphaned RST pages in the documentation tree -- these are 
files that are in our source tree, but are not linked to by any table of 
contents within the documentation.

It's possible that some of these were started but not completed, or 
obsoleted but not fully removed.  I've looked up the last few authors of 
each file -- can you help me triage them?

faq/environment_variables.rst (John, Darren)
mpl_toolkits/axes_grid/index.rst (Jae-Joon, Paul)
mpl_toolkits/mplot3d/index.rst (Reinier)
users/arraydata.rst (Eric)
users/plotting.rst (John)

Mike

-- 
Michael Droettboom
Science Software Branch
Space Telescope Science Institute
Baltimore, Maryland, USA

On Thu, Mar 31, 2011 at 10:33 AM, Michael Droettboom <md...@st...>wrote:

> We have a few orphaned RST pages in the documentation tree -- these are
> files that are in our source tree, but are not linked to by any table of
> contents within the documentation.
>
> It's possible that some of these were started but not completed, or
> obsoleted but not fully removed.  I've looked up the last few authors of
> each file -- can you help me triage them?
>
> faq/environment_variables.rst (John, Darren)
> mpl_toolkits/axes_grid/index.rst (Jae-Joon, Paul)
> mpl_toolkits/mplot3d/index.rst (Reinier)
> users/arraydata.rst (Eric)
> users/plotting.rst (John)
>
> Mike
>
> --
> Michael Droettboom
> Science Software Branch
> Space Telescope Science Institute
> Baltimore, Maryland, USA
>
>
For mpl_toolkits/mplot3d/index.rst, I cleaned it up and improved it
slightly, but I have no clue where in the broader documentation it belongs.
Maybe we need an entry for mpl_toolkit items?

Ben Root

On 03/31/2011 11:46 AM, Benjamin Root wrote:
> On Thu, Mar 31, 2011 at 10:33 AM, Michael Droettboom <md...@st... 
> <mailto:md...@st...>> wrote:
>
>     We have a few orphaned RST pages in the documentation tree --
>     these are
>     files that are in our source tree, but are not linked to by any
>     table of
>     contents within the documentation.
>
>     It's possible that some of these were started but not completed, or
>     obsoleted but not fully removed.  I've looked up the last few
>     authors of
>     each file -- can you help me triage them?
>
>     faq/environment_variables.rst (John, Darren)
>     mpl_toolkits/axes_grid/index.rst (Jae-Joon, Paul)
>     mpl_toolkits/mplot3d/index.rst (Reinier)
>     users/arraydata.rst (Eric)
>     users/plotting.rst (John)
>
>     Mike
>
>     --
>     Michael Droettboom
>     Science Software Branch
>     Space Telescope Science Institute
>     Baltimore, Maryland, USA
>
>
> For mpl_toolkits/mplot3d/index.rst, I cleaned it up and improved it 
> slightly, but I have no clue where in the broader documentation it 
> belongs.  Maybe we need an entry for mpl_toolkit items?
Yes.  I think we should add a toolkit category to the table of contents 
and add this and AxesGrid there.

Mike

-- 
Michael Droettboom
Science Software Branch
Space Telescope Science Institute
Baltimore, Maryland, USA

Michael Droettboom, on 2011-03-31 12:04,  wrote:
> On 03/31/2011 11:46 AM, Benjamin Root wrote:
> > Maybe we need an entry for mpl_toolkit items?
> Yes.  I think we should add a toolkit category to the table of
> contents and add this and AxesGrid there.

+1 

I guess I always find the docs for those using the search, but
it'd be better to have them at least somewhat integrated with the
rest of the docs. Plus it will bring the zeroth Betti number down
for the docs, and I'd consider it a bug if that number is
anything other than 1. 


(Can you tell I've been reading a pop-math book lately?
_Poincaré's prize_ is actually quite accessbile)
-- 
Paul Ivanov
314 address only used for lists,  off-list direct email at:
http://pirsquared.org | GPG/PGP key id: 0x0F3E28F7 

On 03/31/2011 05:33 AM, Michael Droettboom wrote:
> We have a few orphaned RST pages in the documentation tree -- these are
> files that are in our source tree, but are not linked to by any table of
> contents within the documentation.
>
> It's possible that some of these were started but not completed, or
> obsoleted but not fully removed.  I've looked up the last few authors of
> each file -- can you help me triage them?
>
> faq/environment_variables.rst (John, Darren)
> mpl_toolkits/axes_grid/index.rst (Jae-Joon, Paul)
> mpl_toolkits/mplot3d/index.rst (Reinier)
> users/arraydata.rst (Eric)

Yes, this is something I started and obviously did not finish. If 
finished, it would be a useful addition to the User's guide.  And now 
while looking at that, I see some errors in the Image Tutorial...

> users/plotting.rst (John)

This was a draft framework for filling out the User's guide.  A push was 
started a couple summers ago, progress was made, but major chunks (some 
of which I signed up for) are still missing.

Eric

>
> Mike
>