[python-committers] what's going on with Misc/NEWS?

Nick Coghlan ncoghlan at gmail.com
Sat May 25 18:05:54 CEST 2013


On Sun, May 26, 2013 at 1:29 AM, Gregory P. Smith <greg at krypto.org> wrote:
> I like where you're heading with this but it still leaves merges during
> Spruits and when a few people are working at once by putting stuff in a
> single file.
>
> Per news item / per issue files for each release that are riled up into the
> actual news file by a release manager run script & commit at release time
> make more sense.

That's heading back to where I started, when people dismissed the idea
as too complex. It's a pretty straightforward change to my previous
suggestion though. Instead of having these layouts:

    NEWS.next/
        3.3.txt
        3.3-only.txt

    NEWS.next/
        3.3.txt
        3.4.txt

You instead have layouts like:

    NEWS.next/
        3.3/
            core/
                issue123456.txt # Core change with issue number
                misc.txt # Core changes without issue numbers
            library/
                issue54321.txt # Library change with issue number
                misc.txt # Library changes without issue numbers
            ...
       3.3-only/
            ...

    NEWS.next/
        3.3/
            ...
        3.4/
            ...

Whether categorisation is done by file prefix or by directories
doesn't make much difference, although I have a slight preference for
separate folders since repeating prefixes feels like irrelevant noise.

The NEWS update script could even use the revision history to decide
which order to add entries to the bulleted list.

Cheers,
Nick.

--
Nick Coghlan   |   ncoghlan at gmail.com   |   Brisbane, Australia


More information about the python-committers mailing list