On Apr 23, 2009, at 12:17 PM, Dag Sverre Seljebotn wrote: > Robert Bradshaw wrote: >> On Apr 23, 2009, at 11:21 AM, Dag Sverre Seljebotn wrote: >> >>> Dag Sverre Seljebotn wrote: >>>> I added a "Documentation" milestone and component. Rushing ahead >>>> to do >>>> other useful stuff instead of staying behind perfecting >>>> documentation >>>> can't be helped IMO, but filing a ticket is much easier to do and >>>> such a >>>> list is probably very useful. >>>> >>>> I could even much easier add the actual documentation text as I go >>>> to a >>>> ticket, which has much lower startup overhead than editing the >>>> documentation itself. >>>> >>>> Let me know if I'm wrong and should remove it again :-) >> >> No, that's a very good idea. >> >>> Also I propose that every such ticket has a "Since" field in the >>> description field. E.g. for packed structs I stated our next >>> release. >>> >>> http://trac.cython.org/cython_trac/ticket/294 >> >> Isn't this redundant with the milestone field? > > I'm sure it can be discussed, but that's an emphatic "no" from me. > > Milestones are mainly for scheduling -- scheduling work and scheduling > branches. If I assigned a doc ticket to 0.11.2, I think that's the > same > as saying "we want to see if we can get this documented before we > release 0.11.2". Which is silly at this stage. (But e.g. in Sage you'd > easily do something like that, i.e. "we want documentation to have > this > quality before releasing". Like the doctests goals.) > > What I want with the "Since" field is to have that more or less > literally end up in the documentation. > > Example: I could create a new doc ticket now for something in buffers > which I remembered, assign it to milestone 0.12 because I'd really > like > to get it done by the 0.12 release, but have a "Since" field of 0.10 > since the feature happened to be available by then.
Ok, you're just proposing a since field for documentation tickets. Yes, that makes more sense now. - Robert _______________________________________________ Cython-dev mailing list [email protected] http://codespeak.net/mailman/listinfo/cython-dev
