[Numpy-discussion] [SciPy-dev] More on Summer NumPy Doc Marathon
Tue Jun 9 11:31:25 CDT 2009
Thanks, Stefan. The lists you suggest already exist (more or less, depending on the "thing," i.e., list of categories, completely, prioritized list of individual items, sort of, at least w/in the categories) on the Milestones page (that's essentially what the Milestones page is) and the list of individual items is far too long to duplicate here, but for everyone's convenience I'll provide the list of categories (at least those for which the goal has not been, or is not close to being, met, which is most of them):
Data type investigation
Logic, comparisons etc.
Random number generation
Other random operations
Boolean set operations
Sums, interpolation, gradients, etc
Arithmetic + basic functions I
Arithmetic + basic functions II
Arithmetic + basic functions III
Masked arrays, II
Masked arrays, III
Masked arrays, IV
Operations on masks
Even more MA functions I
Even more MA functions II
The matrix library
Other array subclasses
Scalar base class
0) The number of individual items in each of these categories varies from one to a few dozen or so
1) Omitted are a few "meta-categories," e.g., "Routines," "Basic Objects," etc.
2) IMO, there are still too many of these (at least too many to not be intimidating in the manner Stefan has implied); I had it in mind to try to create an intermediate level of organization, i.e., "meso-categories," but I couldn't really justify it on grounds other than there are simply still too many categories to be unintimidating, so I was advised against usage of time in that endeavor. However, if there's an outpouring of support for me doing that, it would fall on sympathetic ears.
As far as prioritizing individual items, my opinion is that team leads should do that (or not, as they deem appropriate) - I wouldn't presume to know enough to do that in most cases. However, if people want to furnish me with suggested prioritizations, I'd be happy to be the one to edit the Wiki to reflect these.
--- On Tue, 6/9/09, Stéfan van der Walt <firstname.lastname@example.org> wrote:
> From: Stéfan van der Walt <email@example.com>
> Subject: Re: [SciPy-dev] More on Summer NumPy Doc Marathon
> To: "SciPy Developers List" <firstname.lastname@example.org>
> Date: Tuesday, June 9, 2009, 1:34 AM
> Hi David
> 2009/6/9 David Goldsmith <email@example.com>:
> > Hi again, folks. I have a special request. Part of
> the vision for my job is that I'll focus my writing efforts
> on the docs no one else is gung-ho to work on. So, even if
> you're not quite ready to commit, if you're leaning toward
> volunteering to be a team lead for one (or more) categories,
> please let me know which one(s) (off list, if you prefer) so
> I can get an initial idea of what the "leftovers" are going
> to be. Thanks!
> That's a pretty wide question. Maybe you could post a
> list of
> categories and ask who would be willing to mentor and write
> on each?
> For the writing, we could decide on a prioritised list of
> publish that list and then document those entries one by
> one (i.e.
> make the tasks small enough so that people don't run away
> Scipy-dev mailing list
More information about the Numpy-discussion