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 >