Guidelines for resolving Jira tickets

[Jacopo Cappellato-3]

To all the committers.

I have recently updated some of the information in Jira to make a better use of this tool: over time this should have a positive impact in the information we will gather and distribute for releases and it will simplify release scheduling.
In order to capture the proper information in Jira when a ticket is resolved or a patch is committed we need to properly set the "Fix Version/s" field; so please read the following notes that describe the new guidelines:

* specify in the "Fix Version/s" the codebase(s) to which you have committed the patch/fix; you can select from the dropdown one or more of the items under the "Unreleased Versions" group in the top part of the drop down box; you should never use one of the items in the "Released Versions" section (bottom part); if the fix/patch is submitted to "Trunk" then select "Upcoming Branch"; if you are backporting/committing to a release branch then select the latest (next) release version in that branch available in the dropdown.

For example at the moment the *valid* items for the "Fix Version/s" field are:
* 11.04.05 (for commits to the branch named release11.04)
* 12.04.04 (for commits to the branch named release12.04)
* 13.07.01 (for commits to the branch named release13.07)
* Upcoming Branch (for commits to trunk)

When we will create the new branch (e.g. 14.08) we will rename "Upcoming Branch" to "14.08.01" and we will create a new Jira version with the name "Upcoming Branch". In this way each future release will have a complete list of tickets associated to it i.e. the changelog.
After some time the following Jira reports will contain very useful information:
* Road Map (what is expected in upcoming releases): https://issues.apache.org/jira/browse/OFBIZ/?selectedTab=com.atlassian.jira.jira-projects-plugin:roadmap-panel
* Change Log (what is available in released packages available from the Download page): https://issues.apache.org/jira/browse/OFBIZ/?selectedTab=com.atlassian.jira.jira-projects-plugin:changelog-panel

Thanks!

Jacopo

[Jacques Le Roux]

Looks like a great improvement for users, thanks Jacopo!

Jacques

Le 14/07/2014 10:27, Jacopo Cappellato a écrit :

> To all the committers.
>
> I have recently updated some of the information in Jira to make a better use of this tool: over time this should have a positive impact in the information we will gather and distribute for releases and it will simplify release scheduling.
> In order to capture the proper information in Jira when a ticket is resolved or a patch is committed we need to properly set the "Fix Version/s" field; so please read the following notes that describe the new guidelines:
>
> * specify in the "Fix Version/s" the codebase(s) to which you have committed the patch/fix; you can select from the dropdown one or more of the items under the "Unreleased Versions" group in the top part of the drop down box; you should never use one of the items in the "Released Versions" section (bottom part); if the fix/patch is submitted to "Trunk" then select "Upcoming Branch"; if you are backporting/committing to a release branch then select the latest (next) release version in that branch available in the dropdown.
>
> For example at the moment the *valid* items for the "Fix Version/s" field are:
> * 11.04.05 (for commits to the branch named release11.04)
> * 12.04.04 (for commits to the branch named release12.04)
> * 13.07.01 (for commits to the branch named release13.07)
> * Upcoming Branch (for commits to trunk)
>
> When we will create the new branch (e.g. 14.08) we will rename "Upcoming Branch" to "14.08.01" and we will create a new Jira version with the name "Upcoming Branch". In this way each future release will have a complete list of tickets associated to it i.e. the changelog.
> After some time the following Jira reports will contain very useful information:
> * Road Map (what is expected in upcoming releases): https://issues.apache.org/jira/browse/OFBIZ/?selectedTab=com.atlassian.jira.jira-projects-plugin:roadmap-panel
> * Change Log (what is available in released packages available from the Download page): https://issues.apache.org/jira/browse/OFBIZ/?selectedTab=com.atlassian.jira.jira-projects-plugin:changelog-panel
>
> Thanks!
>
> Jacopo
>

--

[Jacopo Cappellato-3]

Thank you Jacques! I am also very confident that this will greatly improve our usage of the information in Jira; it took me time to learn how to implement it properly and I am quite happy now about the new setup. Now we shouldn't need to manually maintain in Confluence a what's new page.

Jacopo

On Jul 14, 2014, at 10:46 AM, Jacques Le Roux <[hidden email]> wrote:

> Looks like a great improvement for users, thanks Jacopo!
>
> Jacques
>
> Le 14/07/2014 10:27, Jacopo Cappellato a écrit :
>> To all the committers.
>>
>> I have recently updated some of the information in Jira to make a better use of this tool: over time this should have a positive impact in the information we will gather and distribute for releases and it will simplify release scheduling.
>> In order to capture the proper information in Jira when a ticket is resolved or a patch is committed we need to properly set the "Fix Version/s" field; so please read the following notes that describe the new guidelines:
>>
>> * specify in the "Fix Version/s" the codebase(s) to which you have committed the patch/fix; you can select from the dropdown one or more of the items under the "Unreleased Versions" group in the top part of the drop down box; you should never use one of the items in the "Released Versions" section (bottom part); if the fix/patch is submitted to "Trunk" then select "Upcoming Branch"; if you are backporting/committing to a release branch then select the latest (next) release version in that branch available in the dropdown.
>>
>> For example at the moment the *valid* items for the "Fix Version/s" field are:
>> * 11.04.05 (for commits to the branch named release11.04)
>> * 12.04.04 (for commits to the branch named release12.04)
>> * 13.07.01 (for commits to the branch named release13.07)
>> * Upcoming Branch (for commits to trunk)
>>
>> When we will create the new branch (e.g. 14.08) we will rename "Upcoming Branch" to "14.08.01" and we will create a new Jira version with the name "Upcoming Branch". In this way each future release will have a complete list of tickets associated to it i.e. the changelog.
>> After some time the following Jira reports will contain very useful information:
>> * Road Map (what is expected in upcoming releases): https://issues.apache.org/jira/browse/OFBIZ/?selectedTab=com.atlassian.jira.jira-projects-plugin:roadmap-panel
>> * Change Log (what is available in released packages available from the Download page): https://issues.apache.org/jira/browse/OFBIZ/?selectedTab=com.atlassian.jira.jira-projects-plugin:changelog-panel
>>
>> Thanks!
>>
>> Jacopo
>>
>
> --

[Jacques Le Roux]

Hi Jacopo,

I have added a warning in the Confluence "what's new page"

Jacques

Le 14/07/2014 10:53, Jacopo Cappellato a écrit :

> Thank you Jacques! I am also very confident that this will greatly improve our usage of the information in Jira; it took me time to learn how to implement it properly and I am quite happy now about the new setup. Now we shouldn't need to manually maintain in Confluence a what's new page.
>
> Jacopo
>
> On Jul 14, 2014, at 10:46 AM, Jacques Le Roux <[hidden email]> wrote:
>
>> Looks like a great improvement for users, thanks Jacopo!
>>
>> Jacques
>>
>> Le 14/07/2014 10:27, Jacopo Cappellato a écrit :
>>> To all the committers.
>>>
>>> I have recently updated some of the information in Jira to make a better use of this tool: over time this should have a positive impact in the information we will gather and distribute for releases and it will simplify release scheduling.
>>> In order to capture the proper information in Jira when a ticket is resolved or a patch is committed we need to properly set the "Fix Version/s" field; so please read the following notes that describe the new guidelines:
>>>
>>> * specify in the "Fix Version/s" the codebase(s) to which you have committed the patch/fix; you can select from the dropdown one or more of the items under the "Unreleased Versions" group in the top part of the drop down box; you should never use one of the items in the "Released Versions" section (bottom part); if the fix/patch is submitted to "Trunk" then select "Upcoming Branch"; if you are backporting/committing to a release branch then select the latest (next) release version in that branch available in the dropdown.
>>>
>>> For example at the moment the *valid* items for the "Fix Version/s" field are:
>>> * 11.04.05 (for commits to the branch named release11.04)
>>> * 12.04.04 (for commits to the branch named release12.04)
>>> * 13.07.01 (for commits to the branch named release13.07)
>>> * Upcoming Branch (for commits to trunk)
>>>
>>> When we will create the new branch (e.g. 14.08) we will rename "Upcoming Branch" to "14.08.01" and we will create a new Jira version with the name "Upcoming Branch". In this way each future release will have a complete list of tickets associated to it i.e. the changelog.
>>> After some time the following Jira reports will contain very useful information:
>>> * Road Map (what is expected in upcoming releases): https://issues.apache.org/jira/browse/OFBIZ/?selectedTab=com.atlassian.jira.jira-projects-plugin:roadmap-panel
>>> * Change Log (what is available in released packages available from the Download page): https://issues.apache.org/jira/browse/OFBIZ/?selectedTab=com.atlassian.jira.jira-projects-plugin:changelog-panel
>>>
>>> Thanks!
>>>
>>> Jacopo
>>>
>> --
>
>

[Jacopo Cappellato-4]

thank you!

Jacopo

On Aug 3, 2014, at 9:46 AM, Jacques Le Roux <[hidden email]> wrote:

> Hi Jacopo,
>
> I have added a warning in the Confluence "what's new page"
>
> Jacques
>
> Le 14/07/2014 10:53, Jacopo Cappellato a écrit :
>> Thank you Jacques! I am also very confident that this will greatly improve our usage of the information in Jira; it took me time to learn how to implement it properly and I am quite happy now about the new setup. Now we shouldn't need to manually maintain in Confluence a what's new page.
>>
>> Jacopo
>>
>> On Jul 14, 2014, at 10:46 AM, Jacques Le Roux <[hidden email]> wrote:
>>
>>> Looks like a great improvement for users, thanks Jacopo!
>>>
>>> Jacques
>>>
>>> Le 14/07/2014 10:27, Jacopo Cappellato a écrit :
>>>> To all the committers.
>>>>
>>>> I have recently updated some of the information in Jira to make a better use of this tool: over time this should have a positive impact in the information we will gather and distribute for releases and it will simplify release scheduling.
>>>> In order to capture the proper information in Jira when a ticket is resolved or a patch is committed we need to properly set the "Fix Version/s" field; so please read the following notes that describe the new guidelines:
>>>>
>>>> * specify in the "Fix Version/s" the codebase(s) to which you have committed the patch/fix; you can select from the dropdown one or more of the items under the "Unreleased Versions" group in the top part of the drop down box; you should never use one of the items in the "Released Versions" section (bottom part); if the fix/patch is submitted to "Trunk" then select "Upcoming Branch"; if you are backporting/committing to a release branch then select the latest (next) release version in that branch available in the dropdown.
>>>>
>>>> For example at the moment the *valid* items for the "Fix Version/s" field are:
>>>> * 11.04.05 (for commits to the branch named release11.04)
>>>> * 12.04.04 (for commits to the branch named release12.04)
>>>> * 13.07.01 (for commits to the branch named release13.07)
>>>> * Upcoming Branch (for commits to trunk)
>>>>
>>>> When we will create the new branch (e.g. 14.08) we will rename "Upcoming Branch" to "14.08.01" and we will create a new Jira version with the name "Upcoming Branch". In this way each future release will have a complete list of tickets associated to it i.e. the changelog.
>>>> After some time the following Jira reports will contain very useful information:
>>>> * Road Map (what is expected in upcoming releases): https://issues.apache.org/jira/browse/OFBIZ/?selectedTab=com.atlassian.jira.jira-projects-plugin:roadmap-panel
>>>> * Change Log (what is available in released packages available from the Download page): https://issues.apache.org/jira/browse/OFBIZ/?selectedTab=com.atlassian.jira.jira-projects-plugin:changelog-panel
>>>>
>>>> Thanks!
>>>>
>>>> Jacopo
>>>>
>>> --
>>
>>

[Jacques Le Roux]

Mmm, just thinking: this also means that we (committers) should ALWAYS create Jira issues before committing new features.

Please committers, to remember! I think it's another step in the right direction, thanks for your efforts!

Jacques

Le 03/08/2014 09:46, Jacques Le Roux a écrit :

> Hi Jacopo,
>
> I have added a warning in the Confluence "what's new page"
>
> Jacques
>
> Le 14/07/2014 10:53, Jacopo Cappellato a écrit :
>> Thank you Jacques! I am also very confident that this will greatly improve our usage of the information in Jira; it took me time to learn how to
>> implement it properly and I am quite happy now about the new setup. Now we shouldn't need to manually maintain in Confluence a what's new page.
>>
>> Jacopo
>>
>> On Jul 14, 2014, at 10:46 AM, Jacques Le Roux <[hidden email]> wrote:
>>
>>> Looks like a great improvement for users, thanks Jacopo!
>>>
>>> Jacques
>>>
>>> Le 14/07/2014 10:27, Jacopo Cappellato a écrit :
>>>> To all the committers.
>>>>
>>>> I have recently updated some of the information in Jira to make a better use of this tool: over time this should have a positive impact in the
>>>> information we will gather and distribute for releases and it will simplify release scheduling.
>>>> In order to capture the proper information in Jira when a ticket is resolved or a patch is committed we need to properly set the "Fix Version/s"
>>>> field; so please read the following notes that describe the new guidelines:
>>>>
>>>> * specify in the "Fix Version/s" the codebase(s) to which you have committed the patch/fix; you can select from the dropdown one or more of the
>>>> items under the "Unreleased Versions" group in the top part of the drop down box; you should never use one of the items in the "Released
>>>> Versions" section (bottom part); if the fix/patch is submitted to "Trunk" then select "Upcoming Branch"; if you are backporting/committing to a
>>>> release branch then select the latest (next) release version in that branch available in the dropdown.
>>>>
>>>> For example at the moment the *valid* items for the "Fix Version/s" field are:
>>>> * 11.04.05 (for commits to the branch named release11.04)
>>>> * 12.04.04 (for commits to the branch named release12.04)
>>>> * 13.07.01 (for commits to the branch named release13.07)
>>>> * Upcoming Branch (for commits to trunk)
>>>>
>>>> When we will create the new branch (e.g. 14.08) we will rename "Upcoming Branch" to "14.08.01" and we will create a new Jira version with the
>>>> name "Upcoming Branch". In this way each future release will have a complete list of tickets associated to it i.e. the changelog.
>>>> After some time the following Jira reports will contain very useful information:
>>>> * Road Map (what is expected in upcoming releases):
>>>> https://issues.apache.org/jira/browse/OFBIZ/?selectedTab=com.atlassian.jira.jira-projects-plugin:roadmap-panel
>>>> * Change Log (what is available in released packages available from the Download page):
>>>> https://issues.apache.org/jira/browse/OFBIZ/?selectedTab=com.atlassian.jira.jira-projects-plugin:changelog-panel
>>>>
>>>> Thanks!
>>>>
>>>> Jacopo
>>>>
>>> --
>>
>>
>

[Jacopo Cappellato-4]

Exactly, thank you Jacques! If we want to see a new feature or relevant bug fix to appear in the release notes of a future release we have to make sure to create (before or after the commit) a Jira ticket with the "fix version" field containing the release we have fixed.
As I mentioned, we can do this even after a commit, as I did for example with these: OFBIZ-5691, OFBIZ-5698
For minor commits this is not needed.

Jacopo

On Aug 3, 2014, at 10:23 AM, Jacques Le Roux <[hidden email]> wrote:

> Mmm, just thinking: this also means that we (committers) should ALWAYS create Jira issues before committing new features.
>
> Please committers, to remember! I think it's another step in the right direction, thanks for your efforts!
>
> Jacques
>
> Le 03/08/2014 09:46, Jacques Le Roux a écrit :
>> Hi Jacopo,
>>
>> I have added a warning in the Confluence "what's new page"
>>
>> Jacques
>>
>> Le 14/07/2014 10:53, Jacopo Cappellato a écrit :
>>> Thank you Jacques! I am also very confident that this will greatly improve our usage of the information in Jira; it took me time to learn how to implement it properly and I am quite happy now about the new setup. Now we shouldn't need to manually maintain in Confluence a what's new page.
>>>
>>> Jacopo
>>>
>>> On Jul 14, 2014, at 10:46 AM, Jacques Le Roux <[hidden email]> wrote:
>>>
>>>> Looks like a great improvement for users, thanks Jacopo!
>>>>
>>>> Jacques
>>>>
>>>> Le 14/07/2014 10:27, Jacopo Cappellato a écrit :
>>>>> To all the committers.
>>>>>
>>>>> I have recently updated some of the information in Jira to make a better use of this tool: over time this should have a positive impact in the information we will gather and distribute for releases and it will simplify release scheduling.
>>>>> In order to capture the proper information in Jira when a ticket is resolved or a patch is committed we need to properly set the "Fix Version/s" field; so please read the following notes that describe the new guidelines:
>>>>>
>>>>> * specify in the "Fix Version/s" the codebase(s) to which you have committed the patch/fix; you can select from the dropdown one or more of the items under the "Unreleased Versions" group in the top part of the drop down box; you should never use one of the items in the "Released Versions" section (bottom part); if the fix/patch is submitted to "Trunk" then select "Upcoming Branch"; if you are backporting/committing to a release branch then select the latest (next) release version in that branch available in the dropdown.
>>>>>
>>>>> For example at the moment the *valid* items for the "Fix Version/s" field are:
>>>>> * 11.04.05 (for commits to the branch named release11.04)
>>>>> * 12.04.04 (for commits to the branch named release12.04)
>>>>> * 13.07.01 (for commits to the branch named release13.07)
>>>>> * Upcoming Branch (for commits to trunk)
>>>>>
>>>>> When we will create the new branch (e.g. 14.08) we will rename "Upcoming Branch" to "14.08.01" and we will create a new Jira version with the name "Upcoming Branch". In this way each future release will have a complete list of tickets associated to it i.e. the changelog.
>>>>> After some time the following Jira reports will contain very useful information:
>>>>> * Road Map (what is expected in upcoming releases): https://issues.apache.org/jira/browse/OFBIZ/?selectedTab=com.atlassian.jira.jira-projects-plugin:roadmap-panel
>>>>> * Change Log (what is available in released packages available from the Download page): https://issues.apache.org/jira/browse/OFBIZ/?selectedTab=com.atlassian.jira.jira-projects-plugin:changelog-panel
>>>>>
>>>>> Thanks!
>>>>>
>>>>> Jacopo
>>>>>
>>>> --
>>>
>>>
>>