Subject: | Functionally unhelpful changelog |
Many of the notes in the changelog in this range are pretty much a waste of text, especially for people who might be getting copies of this file to read in an offline scenario:
https://metacpan.org/source/MANWAR/CGI-Simple-1.25/Changes#L3-49
Please, do try to itemize the actual changes that may impact end users.
Each line I'm asking myself
- Ok, where is that bug tracked? (Assume somebody outside the perl ecosystem is reading it )
- Ok, what's the likelihood that where this bug was tracked has changed since a line in the release notes about it was added, and now it no longer references the issue?
- What actual change happened here?
- Should I be cautious about my code needing to be changed?
This present format omits pretty much all the useful details, and leaves only breadcrumbs that only the most committed will be able to break down and understand.
Like for instance, this: https://github.com/manwar/CGI--Simple/pull/9 is the sort of thing one wants to see mentioned explicitly in the changelog, as is, they see "merged a PR" and it could be a trivial doc change, or a complex and breaking feature change.
--
- CPAN kentnl@cpan.org
- Gentoo Perl Maintainer kentnl@gentoo.org ( perl@gentoo.org )
https://metacpan.org/source/MANWAR/CGI-Simple-1.25/Changes#L3-49
Please, do try to itemize the actual changes that may impact end users.
Each line I'm asking myself
- Ok, where is that bug tracked? (Assume somebody outside the perl ecosystem is reading it )
- Ok, what's the likelihood that where this bug was tracked has changed since a line in the release notes about it was added, and now it no longer references the issue?
- What actual change happened here?
- Should I be cautious about my code needing to be changed?
This present format omits pretty much all the useful details, and leaves only breadcrumbs that only the most committed will be able to break down and understand.
Like for instance, this: https://github.com/manwar/CGI--Simple/pull/9 is the sort of thing one wants to see mentioned explicitly in the changelog, as is, they see "merged a PR" and it could be a trivial doc change, or a complex and breaking feature change.
--
- CPAN kentnl@cpan.org
- Gentoo Perl Maintainer kentnl@gentoo.org ( perl@gentoo.org )