+1
On Wed, 28 Aug 2019 21:17:49 +0200, Enrico Olivelli
wrote:
Hi,
We have solved 52 issues:
https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12316922&version=12345234
There are issues left in JIRA for Maven core:
https://issues.apache.org/jira/issues/?jql=project%20%3D%20M
We have contributors listed directly in the POM
https://github.com/apache/maven/blob/master/pom.xml#L120
If we started with this great idea to list contributors in POM, we should
continue with it and this is the same privilege for future contributurs as
well. They will be listed on the Maven sites
My 2cts would be that maybe we are mixing things (all points "IMHO" but
trying to make them short):
1. Changelog: jira+github driven, must be exhaustive about changes and stay
forever with a permalink on the website
2. Release notes: some highlights from the changelog, likely user impacts
mainly a
In my opinion release notes should tell:
- new features/news and noteworthy
- user visible changes
- breaking changes
I would add a list of contributors.
The list of 'reporters' is not useful.
I see we are doing those lists in order to have a better engagement with
the community, but I am not sur
For me and many users the Release Note like this are very hard to read and
hard to find what is needed.
Many times they go to google because it's easier to search than walking
through all versions of release notes.
We do not have a cumulative documentation with a list of features and we
often poin
The goal of release notes is that they are being read.
There should be a good balance of the amount of information, preventing
people to say TLDR;
A long list of 'MNG- John Doe' doesn't provide me useful information.
The list of 'MNG- A good JIRA title' is useful and visiting the
rel
We should use authors of the issue/PR/idea.
After the release we can ask WHY (practical goals) he wanted the feature
more than how. The question for "HOW" has to be placed very early during
the review, but too late after the PR has been merged.
I expect that the reviewer developer has checked all t
