You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@commons.apache.org by Henri Yandell <fl...@gmail.com> on 2013/10/22 20:40:38 UTC

[maven build] Jira report?

Anyone know what the point of the JIRA report is?

It seems to be much like the changes report, but with less active
authorship and a confusing inclusion of resolved issues for different
versions.

I'm wondering why we include it.

Hen

Re: [maven build] Jira report?

Posted by Matt Benson <gu...@gmail.com>.
On Wed, Oct 23, 2013 at 12:15 PM, Gary Gregory <ga...@gmail.com>wrote:

> One of the problems I have is that we do not solve is the following story
> well, and it is not a particular problem of Commons or the ASF: I want to
> update from [foo] version 2 to the current version 5. How do I know what's
> changed and what I need to do to migrate/upgrade?
>
> The first thing I do is look at the Release Notes (RN). Sometimes we have
> the RN cover ONLY the current version (bad). Sometimes the RN cover all
> versions (good) with the newest at the top.
>
> The last thing I want to do is start navigating JIRA and click around for
> an hour in different versions, reports, filters and so on. Worse (and I've
> had to do this with some software), is that I have to download all versions
> and check their release notes.
>
> If I have no good release notes to work with, I have the changes report and
> the JIRA report. The JIRA report is automatically generated, which is good.
> The changes report depends on the diligence of the developers having kept
> up to date the data. Humans = potential for errors; computers = less so ;)
>
> So I am not crazy about removing information for a given component unless
> the RN is of the historical nature.
>
>
I felt like Hen had done quite a good job with the lang3 migration guide.

Matt


> Gary
>
>
> On Wed, Oct 23, 2013 at 12:58 PM, Henri Yandell <fl...@gmail.com>
> wrote:
>
> > On Tue, Oct 22, 2013 at 12:04 PM, Benedikt Ritter <britter@apache.org
> > >wrote:
> >
> > > 2013/10/22 sebb <se...@gmail.com>
> > >
> > > > On 22 October 2013 19:40, Henri Yandell <fl...@gmail.com> wrote:
> > > > > Anyone know what the point of the JIRA report is?
> > > > >
> > > > > It seems to be much like the changes report, but with less active
> > > > > authorship and a confusing inclusion of resolved issues for
> different
> > > > > versions.
> > > > >
> > > > > I'm wondering why we include it.
> > > >
> > > > The changes report only includes changes for the current version.
> > > >
> > > > The JIRA report includes changes for multiple versions; provided that
> > > > the sort mode is correct - and provided that the JIRA fix versions
> are
> > > > set up correctly - it would be more useful than just the changes
> > > > report.
> > > >
> > >
> > > It just duplicates what we have in the release notes. And since the
> site
> > > can change anytime, I'm not giving to much about the reports at all
> > (after
> > > the release vote). But that's a different issue.
> > >
> > >
> > Agreed on both issues :)
> >
> > Sebb points out that JIRA report has more info, but given its an out of
> > date version of JIRA itself, I'm not seeing why we would want the JIRA
> > report (even more so than the others).
> >
> > Any reason to keep it turned on for Commons?
> >
> > Hen
> >
>
>
>
> --
> E-Mail: garydgregory@gmail.com | ggregory@apache.org
> Java Persistence with Hibernate, Second Edition<
> http://www.manning.com/bauer3/>
> JUnit in Action, Second Edition <http://www.manning.com/tahchiev/>
> Spring Batch in Action <http://www.manning.com/templier/>
> Blog: http://garygregory.wordpress.com
> Home: http://garygregory.com/
> Tweet! http://twitter.com/GaryGregory
>

Re: [maven build] Jira report?

Posted by Henri Yandell <fl...@gmail.com>.
Can you point me to a good JIRA report? The Lang one is worthless, so maybe
the issue is that I don't understand what good would be :)


On Wed, Oct 23, 2013 at 10:15 AM, Gary Gregory <ga...@gmail.com>wrote:

> One of the problems I have is that we do not solve is the following story
> well, and it is not a particular problem of Commons or the ASF: I want to
> update from [foo] version 2 to the current version 5. How do I know what's
> changed and what I need to do to migrate/upgrade?
>
> The first thing I do is look at the Release Notes (RN). Sometimes we have
> the RN cover ONLY the current version (bad). Sometimes the RN cover all
> versions (good) with the newest at the top.
>
> The last thing I want to do is start navigating JIRA and click around for
> an hour in different versions, reports, filters and so on. Worse (and I've
> had to do this with some software), is that I have to download all versions
> and check their release notes.
>
> If I have no good release notes to work with, I have the changes report and
> the JIRA report. The JIRA report is automatically generated, which is good.
> The changes report depends on the diligence of the developers having kept
> up to date the data. Humans = potential for errors; computers = less so ;)
>
> So I am not crazy about removing information for a given component unless
> the RN is of the historical nature.
>
> Gary
>
>
> On Wed, Oct 23, 2013 at 12:58 PM, Henri Yandell <fl...@gmail.com>
> wrote:
>
> > On Tue, Oct 22, 2013 at 12:04 PM, Benedikt Ritter <britter@apache.org
> > >wrote:
> >
> > > 2013/10/22 sebb <se...@gmail.com>
> > >
> > > > On 22 October 2013 19:40, Henri Yandell <fl...@gmail.com> wrote:
> > > > > Anyone know what the point of the JIRA report is?
> > > > >
> > > > > It seems to be much like the changes report, but with less active
> > > > > authorship and a confusing inclusion of resolved issues for
> different
> > > > > versions.
> > > > >
> > > > > I'm wondering why we include it.
> > > >
> > > > The changes report only includes changes for the current version.
> > > >
> > > > The JIRA report includes changes for multiple versions; provided that
> > > > the sort mode is correct - and provided that the JIRA fix versions
> are
> > > > set up correctly - it would be more useful than just the changes
> > > > report.
> > > >
> > >
> > > It just duplicates what we have in the release notes. And since the
> site
> > > can change anytime, I'm not giving to much about the reports at all
> > (after
> > > the release vote). But that's a different issue.
> > >
> > >
> > Agreed on both issues :)
> >
> > Sebb points out that JIRA report has more info, but given its an out of
> > date version of JIRA itself, I'm not seeing why we would want the JIRA
> > report (even more so than the others).
> >
> > Any reason to keep it turned on for Commons?
> >
> > Hen
> >
>
>
>
> --
> E-Mail: garydgregory@gmail.com | ggregory@apache.org
> Java Persistence with Hibernate, Second Edition<
> http://www.manning.com/bauer3/>
> JUnit in Action, Second Edition <http://www.manning.com/tahchiev/>
> Spring Batch in Action <http://www.manning.com/templier/>
> Blog: http://garygregory.wordpress.com
> Home: http://garygregory.com/
> Tweet! http://twitter.com/GaryGregory
>

Re: [maven build] Jira report?

Posted by Gary Gregory <ga...@gmail.com>.
On Wed, Oct 23, 2013 at 9:33 PM, sebb <se...@gmail.com> wrote:

> On 23 October 2013 18:15, Gary Gregory <ga...@gmail.com> wrote:
> > One of the problems I have is that we do not solve is the following story
> > well, and it is not a particular problem of Commons or the ASF: I want to
> > update from [foo] version 2 to the current version 5. How do I know
> what's
> > changed and what I need to do to migrate/upgrade?
> >
> > The first thing I do is look at the Release Notes (RN). Sometimes we have
> > the RN cover ONLY the current version (bad). Sometimes the RN cover all
> > versions (good) with the newest at the top.
>
> The changes report should show all the changes; see for example:
>
> http://commons.apache.org/proper/commons-net/changes-report.html
>
> I think the release notes should only relate to the current release,
> but other documents can hold historic changes.
>
> For another example, JMeter splits the two:
>
> http://jmeter.apache.org/changes.html
> and
> http://jmeter.apache.org/changes_history.html
>

Well, that's not a bad way to do it I suppose.

Gary

>
> > The last thing I want to do is start navigating JIRA and click around for
> > an hour in different versions, reports, filters and so on. Worse (and
> I've
> > had to do this with some software), is that I have to download all
> versions
> > and check their release notes.
>
> Try finding any Maven plugin release notes.
> AFAICT, they only include the release notes (such as they are) in the
> announcement e-mail.
>
> > If I have no good release notes to work with, I have the changes report
> and
> > the JIRA report. The JIRA report is automatically generated, which is
> good.
> > The changes report depends on the diligence of the developers having kept
> > up to date the data. Humans = potential for errors; computers = less so
> ;)
> >
> > So I am not crazy about removing information for a given component unless
> > the RN is of the historical nature.
> >
> > Gary
> >
> >
> > On Wed, Oct 23, 2013 at 12:58 PM, Henri Yandell <fl...@gmail.com>
> wrote:
> >
> >> On Tue, Oct 22, 2013 at 12:04 PM, Benedikt Ritter <britter@apache.org
> >> >wrote:
> >>
> >> > 2013/10/22 sebb <se...@gmail.com>
> >> >
> >> > > On 22 October 2013 19:40, Henri Yandell <fl...@gmail.com> wrote:
> >> > > > Anyone know what the point of the JIRA report is?
> >> > > >
> >> > > > It seems to be much like the changes report, but with less active
> >> > > > authorship and a confusing inclusion of resolved issues for
> different
> >> > > > versions.
> >> > > >
> >> > > > I'm wondering why we include it.
> >> > >
> >> > > The changes report only includes changes for the current version.
> >> > >
> >> > > The JIRA report includes changes for multiple versions; provided
> that
> >> > > the sort mode is correct - and provided that the JIRA fix versions
> are
> >> > > set up correctly - it would be more useful than just the changes
> >> > > report.
> >> > >
> >> >
> >> > It just duplicates what we have in the release notes. And since the
> site
> >> > can change anytime, I'm not giving to much about the reports at all
> >> (after
> >> > the release vote). But that's a different issue.
> >> >
> >> >
> >> Agreed on both issues :)
> >>
> >> Sebb points out that JIRA report has more info, but given its an out of
> >> date version of JIRA itself, I'm not seeing why we would want the JIRA
> >> report (even more so than the others).
> >>
> >> Any reason to keep it turned on for Commons?
> >>
> >> Hen
> >>
> >
> >
> >
> > --
> > E-Mail: garydgregory@gmail.com | ggregory@apache.org
> > Java Persistence with Hibernate, Second Edition<
> http://www.manning.com/bauer3/>
> > JUnit in Action, Second Edition <http://www.manning.com/tahchiev/>
> > Spring Batch in Action <http://www.manning.com/templier/>
> > Blog: http://garygregory.wordpress.com
> > Home: http://garygregory.com/
> > Tweet! http://twitter.com/GaryGregory
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
> For additional commands, e-mail: dev-help@commons.apache.org
>
>


-- 
E-Mail: garydgregory@gmail.com | ggregory@apache.org
Java Persistence with Hibernate, Second Edition<http://www.manning.com/bauer3/>
JUnit in Action, Second Edition <http://www.manning.com/tahchiev/>
Spring Batch in Action <http://www.manning.com/templier/>
Blog: http://garygregory.wordpress.com
Home: http://garygregory.com/
Tweet! http://twitter.com/GaryGregory

Re: [maven build] Jira report?

Posted by sebb <se...@gmail.com>.
On 23 October 2013 18:15, Gary Gregory <ga...@gmail.com> wrote:
> One of the problems I have is that we do not solve is the following story
> well, and it is not a particular problem of Commons or the ASF: I want to
> update from [foo] version 2 to the current version 5. How do I know what's
> changed and what I need to do to migrate/upgrade?
>
> The first thing I do is look at the Release Notes (RN). Sometimes we have
> the RN cover ONLY the current version (bad). Sometimes the RN cover all
> versions (good) with the newest at the top.

The changes report should show all the changes; see for example:

http://commons.apache.org/proper/commons-net/changes-report.html

I think the release notes should only relate to the current release,
but other documents can hold historic changes.

For another example, JMeter splits the two:

http://jmeter.apache.org/changes.html
and
http://jmeter.apache.org/changes_history.html

> The last thing I want to do is start navigating JIRA and click around for
> an hour in different versions, reports, filters and so on. Worse (and I've
> had to do this with some software), is that I have to download all versions
> and check their release notes.

Try finding any Maven plugin release notes.
AFAICT, they only include the release notes (such as they are) in the
announcement e-mail.

> If I have no good release notes to work with, I have the changes report and
> the JIRA report. The JIRA report is automatically generated, which is good.
> The changes report depends on the diligence of the developers having kept
> up to date the data. Humans = potential for errors; computers = less so ;)
>
> So I am not crazy about removing information for a given component unless
> the RN is of the historical nature.
>
> Gary
>
>
> On Wed, Oct 23, 2013 at 12:58 PM, Henri Yandell <fl...@gmail.com> wrote:
>
>> On Tue, Oct 22, 2013 at 12:04 PM, Benedikt Ritter <britter@apache.org
>> >wrote:
>>
>> > 2013/10/22 sebb <se...@gmail.com>
>> >
>> > > On 22 October 2013 19:40, Henri Yandell <fl...@gmail.com> wrote:
>> > > > Anyone know what the point of the JIRA report is?
>> > > >
>> > > > It seems to be much like the changes report, but with less active
>> > > > authorship and a confusing inclusion of resolved issues for different
>> > > > versions.
>> > > >
>> > > > I'm wondering why we include it.
>> > >
>> > > The changes report only includes changes for the current version.
>> > >
>> > > The JIRA report includes changes for multiple versions; provided that
>> > > the sort mode is correct - and provided that the JIRA fix versions are
>> > > set up correctly - it would be more useful than just the changes
>> > > report.
>> > >
>> >
>> > It just duplicates what we have in the release notes. And since the site
>> > can change anytime, I'm not giving to much about the reports at all
>> (after
>> > the release vote). But that's a different issue.
>> >
>> >
>> Agreed on both issues :)
>>
>> Sebb points out that JIRA report has more info, but given its an out of
>> date version of JIRA itself, I'm not seeing why we would want the JIRA
>> report (even more so than the others).
>>
>> Any reason to keep it turned on for Commons?
>>
>> Hen
>>
>
>
>
> --
> E-Mail: garydgregory@gmail.com | ggregory@apache.org
> Java Persistence with Hibernate, Second Edition<http://www.manning.com/bauer3/>
> JUnit in Action, Second Edition <http://www.manning.com/tahchiev/>
> Spring Batch in Action <http://www.manning.com/templier/>
> Blog: http://garygregory.wordpress.com
> Home: http://garygregory.com/
> Tweet! http://twitter.com/GaryGregory

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
For additional commands, e-mail: dev-help@commons.apache.org


Re: [maven build] Jira report?

Posted by Gary Gregory <ga...@gmail.com>.
One of the problems I have is that we do not solve is the following story
well, and it is not a particular problem of Commons or the ASF: I want to
update from [foo] version 2 to the current version 5. How do I know what's
changed and what I need to do to migrate/upgrade?

The first thing I do is look at the Release Notes (RN). Sometimes we have
the RN cover ONLY the current version (bad). Sometimes the RN cover all
versions (good) with the newest at the top.

The last thing I want to do is start navigating JIRA and click around for
an hour in different versions, reports, filters and so on. Worse (and I've
had to do this with some software), is that I have to download all versions
and check their release notes.

If I have no good release notes to work with, I have the changes report and
the JIRA report. The JIRA report is automatically generated, which is good.
The changes report depends on the diligence of the developers having kept
up to date the data. Humans = potential for errors; computers = less so ;)

So I am not crazy about removing information for a given component unless
the RN is of the historical nature.

Gary


On Wed, Oct 23, 2013 at 12:58 PM, Henri Yandell <fl...@gmail.com> wrote:

> On Tue, Oct 22, 2013 at 12:04 PM, Benedikt Ritter <britter@apache.org
> >wrote:
>
> > 2013/10/22 sebb <se...@gmail.com>
> >
> > > On 22 October 2013 19:40, Henri Yandell <fl...@gmail.com> wrote:
> > > > Anyone know what the point of the JIRA report is?
> > > >
> > > > It seems to be much like the changes report, but with less active
> > > > authorship and a confusing inclusion of resolved issues for different
> > > > versions.
> > > >
> > > > I'm wondering why we include it.
> > >
> > > The changes report only includes changes for the current version.
> > >
> > > The JIRA report includes changes for multiple versions; provided that
> > > the sort mode is correct - and provided that the JIRA fix versions are
> > > set up correctly - it would be more useful than just the changes
> > > report.
> > >
> >
> > It just duplicates what we have in the release notes. And since the site
> > can change anytime, I'm not giving to much about the reports at all
> (after
> > the release vote). But that's a different issue.
> >
> >
> Agreed on both issues :)
>
> Sebb points out that JIRA report has more info, but given its an out of
> date version of JIRA itself, I'm not seeing why we would want the JIRA
> report (even more so than the others).
>
> Any reason to keep it turned on for Commons?
>
> Hen
>



-- 
E-Mail: garydgregory@gmail.com | ggregory@apache.org
Java Persistence with Hibernate, Second Edition<http://www.manning.com/bauer3/>
JUnit in Action, Second Edition <http://www.manning.com/tahchiev/>
Spring Batch in Action <http://www.manning.com/templier/>
Blog: http://garygregory.wordpress.com
Home: http://garygregory.com/
Tweet! http://twitter.com/GaryGregory

Re: [maven build] Jira report?

Posted by Henri Yandell <fl...@gmail.com>.
On Tue, Oct 22, 2013 at 12:04 PM, Benedikt Ritter <br...@apache.org>wrote:

> 2013/10/22 sebb <se...@gmail.com>
>
> > On 22 October 2013 19:40, Henri Yandell <fl...@gmail.com> wrote:
> > > Anyone know what the point of the JIRA report is?
> > >
> > > It seems to be much like the changes report, but with less active
> > > authorship and a confusing inclusion of resolved issues for different
> > > versions.
> > >
> > > I'm wondering why we include it.
> >
> > The changes report only includes changes for the current version.
> >
> > The JIRA report includes changes for multiple versions; provided that
> > the sort mode is correct - and provided that the JIRA fix versions are
> > set up correctly - it would be more useful than just the changes
> > report.
> >
>
> It just duplicates what we have in the release notes. And since the site
> can change anytime, I'm not giving to much about the reports at all (after
> the release vote). But that's a different issue.
>
>
Agreed on both issues :)

Sebb points out that JIRA report has more info, but given its an out of
date version of JIRA itself, I'm not seeing why we would want the JIRA
report (even more so than the others).

Any reason to keep it turned on for Commons?

Hen

Re: [maven build] Jira report?

Posted by Benedikt Ritter <br...@apache.org>.
2013/10/22 sebb <se...@gmail.com>

> On 22 October 2013 19:40, Henri Yandell <fl...@gmail.com> wrote:
> > Anyone know what the point of the JIRA report is?
> >
> > It seems to be much like the changes report, but with less active
> > authorship and a confusing inclusion of resolved issues for different
> > versions.
> >
> > I'm wondering why we include it.
>
> The changes report only includes changes for the current version.
>
> The JIRA report includes changes for multiple versions; provided that
> the sort mode is correct - and provided that the JIRA fix versions are
> set up correctly - it would be more useful than just the changes
> report.
>

It just duplicates what we have in the release notes. And since the site
can change anytime, I'm not giving to much about the reports at all (after
the release vote). But that's a different issue.


>
> > Hen
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
> For additional commands, e-mail: dev-help@commons.apache.org
>
>


-- 
http://people.apache.org/~britter/
http://www.systemoutprintln.de/
http://twitter.com/BenediktRitter
http://github.com/britter

Re: [maven build] Jira report?

Posted by sebb <se...@gmail.com>.
On 22 October 2013 19:40, Henri Yandell <fl...@gmail.com> wrote:
> Anyone know what the point of the JIRA report is?
>
> It seems to be much like the changes report, but with less active
> authorship and a confusing inclusion of resolved issues for different
> versions.
>
> I'm wondering why we include it.

The changes report only includes changes for the current version.

The JIRA report includes changes for multiple versions; provided that
the sort mode is correct - and provided that the JIRA fix versions are
set up correctly - it would be more useful than just the changes
report.

> Hen

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
For additional commands, e-mail: dev-help@commons.apache.org