Stories
Slash Boxes
Comments
NOTE: use Perl; is on undef hiatus. You can read content, but you can't post it. More info will be forthcoming forthcomingly.

All the Perl that's Practical to Extract and Report

The Fine Print: The following comments are owned by whoever posted them. We are not responsible for them in any way.
 Full
 Abbreviated
 Hidden
More | Login | Reply
Loading... please wait.
  • I've been doing CPAN Watch [perlbuzz.com] for a couple of weeks now and I'm starting to get a handle on what I'd want if I had a machine-parsable changelog. A few random notes:

    To me, the main distinction in changelogs is "noteworthy" and "not noteworthy". Bugfixes, additional features, and breaking backwards compatibility are noteworthy. Things like packaging fixes, test improvements, etc are not noteworthy. Admittedly my criteria are very personal here, but I think the distinction of "you might want to upgrade on

    --
    Kirrily "Skud" Robert perl@infotrope.net http://infotrope.net/
    • Hmm, cpan watch would really be a major user of this, so I'll keep that in mind. So I guess making too many things in Changes.yml optional is bad, either an author should include all infos or just leave out Changes.yml alltogether.

      So the release info should contain human-readable info on the one hand like a one-sentence synopsis for cpan-watch and parseable info on the other hand like API-changes, changes in dependencies etc that allows some nifty tools to combine that with info from other packages to e.g.
      • META.yml is rather established, and quite useful for determining the current state of a package. I don't think it's productive to speculating in merging files or making one replace the other.

        Instead, I suggest that Changes.yml ONLY contains information regarding the changes between releases (as opposed to info regarding about the release itself, which is available in META.yml). That would mean fields like "author" should be redundant/meaningless in Changes.yml.

        Furthermore, there's much to be won by maki

        • Right, I don't intend to merge files, and be it just for backward-compatibility.

          With "author" I meant the author of that specific release, not necessarily of the whole module. I don't know if "pumpking" would be better, as I see that title as a honor to those that coordinate releases on really large module/packages/whatever. Maybe "brought-to-you-by" would be better... No, let that be "release-author". :-)

          [Which brings me to the point if there shouldn't be a list of bug/patch contributors that could be automatically parsed and assembled to a "honorable mentions" page somewhere...]

          Regarding the optional info, I would go another way that strikes me as psychologically good, I would provide a template that contains all the tags with default values, so if an author doesn't want to fill something out, he doesn't need to because it is already filled out. This template would ideally be auto-generated in the standard "perl Makefile.PL" process.

          And as a second step I would vote for a nag message for "make dist" that would check the existance of a Changes.yml file and nag the author to fill out the template (without requiring it), also giving a link to more info about Changes.yml.