[Twisted-Python] Review process, news fragments
James Y Knight
foom at fuhm.net
Mon Jun 21 08:12:02 MDT 2010
On Jun 20, 2010, at 6:26 PM, exarkun at twistedmatrix.com wrote:
> Obviously this is English prose we're talking about here, and
> there's a
> lot of room for variation. I don't want to impose a *strict* style
> guide here. I do want the fragments to all aim for roughly the same
> level of detail, and they should all at least make sense to a reader
> who
> hasn't looked at the history of the relevant ticket. And where it
> makes
> sense, I'd like the presentation of the information (like the age of
> the
> deprecation on an API being removed or changed) to be uniform.
I think the only real way to ensure this is to have a human edit the
information after it's concatenated together, before release. Having
pre-written news fragments from all the authors of the changes makes
that task a lot easier, but I think you really need to see everything
together in one file and have a single person apply some editorial
judgement to the result to have it come out well.
James
More information about the Twisted-Python
mailing list