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

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 Thu, Mar 31, 2011 at 10:33 AM, Michael Droettboom <mdroe@…31…> 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

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:

> 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)

···

On 03/31/2011 11:46 AM, Benjamin Root wrote:

--
Paul Ivanov
314 address only used for lists, off-list direct email at:
http://pirsquared.org | GPG/PGP key id: 0x0F3E28F7

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

···

On 03/31/2011 05:33 AM, Michael Droettboom wrote:

Mike