<div>I think we should change the roles established for the Numpy/Scipy documentation editors because they do not work as intended.</div><div><br></div><div>For reference they are described here: <a href="http://docs.scipy.org/numpy/Front%20Page/">http://docs.scipy.org/numpy/Front%20Page/</a> </div>
<div><br></div><div>Basically there aren't that many active people to support being split into the roles as described which has led to a backlog of 'Needs review' docstrings and only one  'Proofed' docstring.  I think that many of these docstrings are good enough, just that not enough people have put themselves out front as so knowledgeable about a certain topic to label docstrings as 'Reviewed' or 'Proofed'.</div>
<div><br></div><div>Here are the current statistics for numpy docstrings:</div><div><h3 style="color:rgb(68,68,85);font-size:12pt;margin-bottom:1ex;font-family:sans-serif">Current</h3><table style="border-top-width:1px;border-right-width:1px;border-bottom-width:1px;border-left-width:1px;border-top-style:solid;border-right-style:solid;border-bottom-style:solid;border-left-style:solid;border-top-color:rgb(204,204,204);border-right-color:rgb(204,204,204);border-bottom-color:rgb(204,204,204);border-left-color:rgb(204,204,204);margin-top:1ex;margin-bottom:1ex;border-collapse:collapse;padding-top:0px;padding-right:0px;padding-bottom:0px;padding-left:0px;color:rgb(0,0,0);font-family:sans-serif;font-size:13px">
<tbody><tr style="padding-left:0.5em;padding-right:0.5em;border-top-width:1px;border-top-style:solid;border-top-color:rgb(0,0,0);border-bottom-width:1px;border-bottom-style:solid;border-bottom-color:rgb(0,0,0)"><th style="color:rgb(68,68,85);padding-right:1em;text-align:left">
</th><th style="color:rgb(68,68,85);padding-right:1em;text-align:left">%</th><th style="color:rgb(68,68,85);padding-right:1em;text-align:left">Count</th></tr><tr style="padding-left:0.5em;padding-right:0.5em;border-top-width:1px;border-top-style:solid;border-top-color:rgb(0,0,0);border-bottom-width:1px;border-bottom-style:solid;border-bottom-color:rgb(0,0,0)">
<td class="needs-editing" style="border-bottom-width:1px;border-bottom-style:solid;border-bottom-color:rgb(204,204,204);padding-right:0.5em;background-image:initial;background-color:rgb(255,255,255);background-repeat:initial initial">
Needs editing</td><td style="border-bottom-width:1px;border-bottom-style:solid;border-bottom-color:rgb(204,204,204);padding-right:0.5em">17</td><td style="border-bottom-width:1px;border-bottom-style:solid;border-bottom-color:rgb(204,204,204);padding-right:0.5em">
279</td></tr><tr style="padding-left:0.5em;padding-right:0.5em;border-top-width:1px;border-top-style:solid;border-top-color:rgb(0,0,0);border-bottom-width:1px;border-bottom-style:solid;border-bottom-color:rgb(0,0,0)"><td class="being-written" style="border-bottom-width:1px;border-bottom-style:solid;border-bottom-color:rgb(204,204,204);padding-right:0.5em;background-image:initial;background-color:rgb(221,221,221);background-repeat:initial initial">
Being written / Changed</td><td style="border-bottom-width:1px;border-bottom-style:solid;border-bottom-color:rgb(204,204,204);padding-right:0.5em">4</td><td style="border-bottom-width:1px;border-bottom-style:solid;border-bottom-color:rgb(204,204,204);padding-right:0.5em">
62</td></tr><tr style="padding-left:0.5em;padding-right:0.5em;border-top-width:1px;border-top-style:solid;border-top-color:rgb(0,0,0);border-bottom-width:1px;border-bottom-style:solid;border-bottom-color:rgb(0,0,0)"><td class="needs-review" style="border-bottom-width:1px;border-bottom-style:solid;border-bottom-color:rgb(204,204,204);padding-right:0.5em;background-image:initial;background-color:rgb(255,170,170);background-repeat:initial initial">
Needs review</td><td style="border-bottom-width:1px;border-bottom-style:solid;border-bottom-color:rgb(204,204,204);padding-right:0.5em">76</td><td style="border-bottom-width:1px;border-bottom-style:solid;border-bottom-color:rgb(204,204,204);padding-right:0.5em">
1235</td></tr><tr style="padding-left:0.5em;padding-right:0.5em;border-top-width:1px;border-top-style:solid;border-top-color:rgb(0,0,0);border-bottom-width:1px;border-bottom-style:solid;border-bottom-color:rgb(0,0,0)"><td class="revised" style="border-bottom-width:1px;border-bottom-style:solid;border-bottom-color:rgb(204,204,204);padding-right:0.5em;background-image:initial;background-color:rgb(255,204,170);background-repeat:initial initial">
Needs review (revised)</td><td style="border-bottom-width:1px;border-bottom-style:solid;border-bottom-color:rgb(204,204,204);padding-right:0.5em">2</td><td style="border-bottom-width:1px;border-bottom-style:solid;border-bottom-color:rgb(204,204,204);padding-right:0.5em">
35</td></tr><tr style="padding-left:0.5em;padding-right:0.5em;border-top-width:1px;border-top-style:solid;border-top-color:rgb(0,0,0);border-bottom-width:1px;border-bottom-style:solid;border-bottom-color:rgb(0,0,0)"><td class="needs-work" style="border-bottom-width:1px;border-bottom-style:solid;border-bottom-color:rgb(204,204,204);padding-right:0.5em;background-image:initial;background-color:rgb(255,255,85);background-repeat:initial initial">
Needs work (reviewed)</td><td style="border-bottom-width:1px;border-bottom-style:solid;border-bottom-color:rgb(204,204,204);padding-right:0.5em">0</td><td style="border-bottom-width:1px;border-bottom-style:solid;border-bottom-color:rgb(204,204,204);padding-right:0.5em">
3</td></tr><tr style="padding-left:0.5em;padding-right:0.5em;border-top-width:1px;border-top-style:solid;border-top-color:rgb(0,0,0);border-bottom-width:1px;border-bottom-style:solid;border-bottom-color:rgb(0,0,0)"><td class="reviewed" style="border-bottom-width:1px;border-bottom-style:solid;border-bottom-color:rgb(204,204,204);padding-right:0.5em;background-image:initial;background-color:rgb(187,255,187);background-repeat:initial initial">
Reviewed (needs proof)</td><td style="border-bottom-width:1px;border-bottom-style:solid;border-bottom-color:rgb(204,204,204);padding-right:0.5em">0</td><td style="border-bottom-width:1px;border-bottom-style:solid;border-bottom-color:rgb(204,204,204);padding-right:0.5em">
0</td></tr><tr style="padding-left:0.5em;padding-right:0.5em;border-top-width:1px;border-top-style:solid;border-top-color:rgb(0,0,0);border-bottom-width:1px;border-bottom-style:solid;border-bottom-color:rgb(0,0,0)"><td class="proofed" style="border-bottom-width:1px;border-bottom-style:solid;border-bottom-color:rgb(204,204,204);padding-right:0.5em;background-image:initial;background-color:rgb(170,170,255);background-repeat:initial initial">
Proofed</td><td style="border-bottom-width:1px;border-bottom-style:solid;border-bottom-color:rgb(204,204,204);padding-right:0.5em">0</td><td style="border-bottom-width:1px;border-bottom-style:solid;border-bottom-color:rgb(204,204,204);padding-right:0.5em">
1</td></tr><tr style="padding-left:0.5em;padding-right:0.5em;border-top-width:1px;border-top-style:solid;border-top-color:rgb(0,0,0);border-bottom-width:1px;border-bottom-style:solid;border-bottom-color:rgb(0,0,0)"><td class="unimportant" style="border-bottom-width:1px;border-bottom-style:solid;border-bottom-color:rgb(204,204,204);padding-right:0.5em;background-image:initial;background-color:rgb(136,136,136);background-repeat:initial initial">
Unimportant</td><td style="border-bottom-width:1px;border-bottom-style:solid;border-bottom-color:rgb(204,204,204);padding-right:0.5em">–</td><td style="border-bottom-width:1px;border-bottom-style:solid;border-bottom-color:rgb(204,204,204);padding-right:0.5em">
1793</td></tr></tbody></table></div><div><br></div><div><br></div><div>I have thought about some solutions in no particular order:</div><div><br></div><div>* Get rid of the 'Reviewer' and 'Proofer' roles.</div>
<div>* Assign all 'Editors', the 'Reviewer', and 'Proofer' privileges.</div><div>* People start out as 'Editors', and then become 'Reviewers', and 'Proofers' based on some editing metric.</div>
<div><br></div><div>For full disclosure, I would be generous with a 'Reviewed' label if given the authority because philosophically I think there should be a point where the docstring is 'Good enough' and it should be expected to have a life of continually small improvements rather that a point when it is 'Done'.</div>
<div><br></div><div>Regardless of what decision is made, the single 'Proofed' docstring should be available for editing.  I can't even find what it is.  I imagine that it should be on the docstring page at <a href="http://docs.scipy.org/numpy/docs/">http://docs.scipy.org/numpy/docs/</a></div>
<div><br></div><div>Kindest regards,</div><div>Tim</div><div><br></div>