Editing comments in Jira

[Jacques Le Roux]

Hi,

I'm in the process of trying to reduce frictions about some acts we not all agree about sometimes.

 From my experience, establishing best practices, policy or rules does much help about that. I think the wiki is still the best place for such
information, notably the

https://cwiki.apache.org/confluence/display/OFBIZ/OFBiz+Contributors+Best+Practices

and

https://cwiki.apache.org/confluence/display/OFBIZ/OFBiz+Committers+Roles+and+Responsibilities

pages.

While reviewing the later I stumbled upon the "Editing comments in Jira" information block. It says

    <<This feature should be used very parsimoniously because it's not easy to read edited comments from a mailing list and most people read comments
    from the dev ML (Jira issues are redirected to dev ML).>>

But, if I'm not wrong (I could be abused by my email clients filters) now the comments are no longer redirected to dev ML but *only* to the "new" 
[hidden email] address.

So should we keep this sentence,? And if not, should we keep this whole information block?

Thanks for your attention

Jacques

[Jacques Le Roux]

Le 27/08/2018 à 10:11, Jacques Le Roux a écrit :

>
> Hi,
>
> I'm in the process of trying to reduce frictions about some acts we not all agree about sometimes.
>
> From my experience, establishing best practices, policy or rules does much help about that. I think the wiki is still the best place for such
> information, notably the
>
> https://cwiki.apache.org/confluence/display/OFBIZ/OFBiz+Contributors+Best+Practices
>
> and
>
> https://cwiki.apache.org/confluence/display/OFBIZ/OFBiz+Committers+Roles+and+Responsibilities
>
> pages.
>
> While reviewing the later I stumbled upon the "Editing comments in Jira" information block. It says
>
>     <<This feature should be used very parsimoniously because it's not easy to read edited comments from a mailing list and most people read
>     comments from the dev ML (Jira issues are redirected to dev ML).>>
>
> But, if I'm not wrong (I could be abused by my email clients filters) now the comments are no longer redirected to dev ML but *only* to the "new"
> [hidden email] address.
>
> So should we keep this sentence,? And if not, should we keep this whole information block?
>
> Thanks for your attention
>
> Jacques

BTW, thinking about it, if we keep this information block, it should not be in the committers page but contributors one. I'll check for other possible
such cases.

Jacques

[Mathieu Lirzin]

Hello Jacques,

Jacques Le Roux <[hidden email]> writes:

> While reviewing the later I stumbled upon the "Editing comments in
> Jira" information block. It says
>
>    <<This feature should be used very parsimoniously because it's not
>    easy to read edited comments from a mailing list and most people
>    read comments from the dev ML (Jira issues are redirected to dev
>    ML).>>
>
[...]
> So should we keep this sentence,? And if not, should we keep this
> whole information block?

The JIRA summary wall [1] is a convenient way to follow OFBiz
development activity.  IMO we should remove this information block and
recommend using JIRA Web Interface instead which doesn't have this
updated comment issue.  <[hidden email]> should only be
mentioned as an alternative in “degraded” mode.

[1] https://issues.apache.org/jira/projects/OFBIZ/summary

--
Mathieu Lirzin
GPG: F2A3 8D7E EB2B 6640 5761  070D 0ADE E100 9460 4D37

[Jacques Le Roux]

Le 27/08/2018 à 11:46, Mathieu Lirzin a écrit :

> Hello Jacques,
>
> Jacques Le Roux <[hidden email]> writes:
>
>> While reviewing the later I stumbled upon the "Editing comments in
>> Jira" information block. It says
>>
>>     <<This feature should be used very parsimoniously because it's not
>>     easy to read edited comments from a mailing list and most people
>>     read comments from the dev ML (Jira issues are redirected to dev
>>     ML).>>
>>
> [...]
>> So should we keep this sentence,? And if not, should we keep this
>> whole information block?
> The JIRA summary wall [1] is a convenient way to follow OFBiz
> development activity.  IMO we should remove this information block and
> recommend using JIRA Web Interface instead which doesn't have this
> updated comment issue.  <[hidden email]> should only be
> mentioned as an alternative in “degraded” mode.
>
> [1] https://issues.apache.org/jira/projects/OFBIZ/summary
>

Thanks for your feedback Mathieu,

This info block relates to people using MLs to follow Jira progress. Using the summary could be an alternative indeed. Though I'm not sure everyone
agree about that. Including myself, I'm an eager MLs user, but I have no problems with edited comments. So let's wait other feedbacks...

Jacques