You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@openoffice.apache.org by Herbert Duerr <hd...@apache.org> on 2014/03/11 12:05:31 UTC
[Bug 124386] Improve Help for Version Selector
Members of our QA team requested a clarification of the "Version" field
used in our bugzilla instance. There are other terms that could need
some clarification too.
So before I request ASF-Infra to change our bugzilla installation by
using the patch [1], I'd like to ask for lazy consensus to request this
change in our bugzilla installation.
[1] https://issues.apache.org/ooo/attachment.cgi?id=82837&action=diff
In particular the help text for "version" should be changed from
"The version field defines the version of the software the bug was
found in."
to
"The oldest version of the software the bug can be found in.",
Also the help text for "assigned to" should be changed from
"The person in charge of resolving the ${terms.bug}."
to
"The person in charge of progressing the ${terms.bug}."
because we sometimes need more info, specific testing, etc. from others.
The help text for "operating system" should be changed from
"The operating system the $terms.bug was observed on."
to
"The operating systems the $terms.bug can be observed on."
because AOO problems are often impacting multiple platforms.
Since many entries in our bugzilla database are not about bugs, but
about new features or enhancements I'd also like to use the term "issue"
instead of "bug", when Bugzilla refers to such an entry.
Herbert
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@openoffice.apache.org
For additional commands, e-mail: dev-help@openoffice.apache.org
Re: Fwd: [Bug 124386] Improve Help for Version Selector
Posted by Rainer Bielefeld <ra...@bielefeldundbuss.de>.
Herbert Duerr schrieb:
> So before I request ASF-Infra to change our bugzilla installation by
> using the patch [1]
Hi,
thank you for initiative, all changed texts portray current
understanding and use better than the old texts.
+1 for all
The question is whether that already is complete of whether we should
think about some other "problem areas". It might be useful to create a
temporary Wiki-Page where we collect and improve some Old / New" texts
(normal texts, without parch syntax). Or simply use
<https://wiki.openoffice.org/wiki/BUGZILLA/FAQ#How_to_improve_Bugzilla_Help_texts>
for a week or so and drop that to Wiki Archive when work has been done.
I think we should try to limit requests to infra team if possible.
Rainer
---------------------------------------------------------------------
To unsubscribe, e-mail: qa-unsubscribe@openoffice.apache.org
For additional commands, e-mail: qa-help@openoffice.apache.org
Fwd: [Bug 124386] Improve Help for Version Selector
Posted by Herbert Duerr <hd...@apache.org>.
Forwarding to the QA mailing list.
-------- Original Message --------
Subject: [Bug 124386] Improve Help for Version Selector
Date: Tue, 11 Mar 2014 12:05:31 +0100
From: Herbert Duerr <hd...@apache.org>
Reply-To: dev@openoffice.apache.org
To: dev@openoffice.apache.org <de...@openoffice.apache.org>
Members of our QA team requested a clarification of the "Version" field
used in our bugzilla instance. There are other terms that could need
some clarification too.
So before I request ASF-Infra to change our bugzilla installation by
using the patch [1], I'd like to ask for lazy consensus to request this
change in our bugzilla installation.
[1] https://issues.apache.org/ooo/attachment.cgi?id=82837&action=diff
In particular the help text for "version" should be changed from
"The version field defines the version of the software the bug was
found in."
to
"The oldest version of the software the bug can be found in.",
Also the help text for "assigned to" should be changed from
"The person in charge of resolving the ${terms.bug}."
to
"The person in charge of progressing the ${terms.bug}."
because we sometimes need more info, specific testing, etc. from others.
The help text for "operating system" should be changed from
"The operating system the $terms.bug was observed on."
to
"The operating systems the $terms.bug can be observed on."
because AOO problems are often impacting multiple platforms.
Since many entries in our bugzilla database are not about bugs, but
about new features or enhancements I'd also like to use the term "issue"
instead of "bug", when Bugzilla refers to such an entry.
Herbert
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@openoffice.apache.org
For additional commands, e-mail: dev-help@openoffice.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: qa-unsubscribe@openoffice.apache.org
For additional commands, e-mail: qa-help@openoffice.apache.org
Re: [Bug 124386] Improve Help for Version Selector
Posted by Oliver-Rainer Wittmann <or...@googlemail.com>.
Hi,
On 11.03.2014 12:05, Herbert Duerr wrote:
> Members of our QA team requested a clarification of the "Version" field
> used in our bugzilla instance. There are other terms that could need
> some clarification too.
>
> So before I request ASF-Infra to change our bugzilla installation by
> using the patch [1], I'd like to ask for lazy consensus to request this
> change in our bugzilla installation.
>
> [1] https://issues.apache.org/ooo/attachment.cgi?id=82837&action=diff
>
> In particular the help text for "version" should be changed from
> "The version field defines the version of the software the bug was
> found in."
> to
> "The oldest version of the software the bug can be found in.",
>
> Also the help text for "assigned to" should be changed from
> "The person in charge of resolving the ${terms.bug}."
> to
> "The person in charge of progressing the ${terms.bug}."
> because we sometimes need more info, specific testing, etc. from others.
>
> The help text for "operating system" should be changed from
> "The operating system the $terms.bug was observed on."
> to
> "The operating systems the $terms.bug can be observed on."
> because AOO problems are often impacting multiple platforms.
>
> Since many entries in our bugzilla database are not about bugs, but
> about new features or enhancements I'd also like to use the term "issue"
> instead of "bug", when Bugzilla refers to such an entry.
>
+1 for the clarifications.
Best regards, Oliver.
> Herbert
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@openoffice.apache.org
> For additional commands, e-mail: dev-help@openoffice.apache.org
>
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@openoffice.apache.org
For additional commands, e-mail: dev-help@openoffice.apache.org
Re: [Bug 124386] Improve Help for Version Selector
Posted by Herbert Duerr <hd...@apache.org>.
On 11.03.2014 13:01, Rob Weir wrote:
> On Tue, Mar 11, 2014 at 7:05 AM, Herbert Duerr <hd...@apache.org> wrote:
>> Members of our QA team requested a clarification of the "Version" field used
>> in our bugzilla instance. There are other terms that could need some
>> clarification too.
>> [...]
>> Also the help text for "assigned to" should be changed from
>> "The person in charge of resolving the ${terms.bug}."
>> to
>> "The person in charge of progressing the ${terms.bug}."
>> because we sometimes need more info, specific testing, etc. from others.
>>
>
> This might be confusing, because we have a separate field for "QA
> Contact". We've been using that field for the person who is testing
> the feature.
>
> Maybe, to be clear, "assigned to" could say something like "The
> *developer* in charge of progressing..."
Good point.
Herbert
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@openoffice.apache.org
For additional commands, e-mail: dev-help@openoffice.apache.org
Re: [Bug 124386] Improve Help for Version Selector
Posted by Rob Weir <ro...@apache.org>.
On Tue, Mar 11, 2014 at 7:05 AM, Herbert Duerr <hd...@apache.org> wrote:
> Members of our QA team requested a clarification of the "Version" field used
> in our bugzilla instance. There are other terms that could need some
> clarification too.
>
> So before I request ASF-Infra to change our bugzilla installation by using
> the patch [1], I'd like to ask for lazy consensus to request this change in
> our bugzilla installation.
>
> [1] https://issues.apache.org/ooo/attachment.cgi?id=82837&action=diff
>
> In particular the help text for "version" should be changed from
> "The version field defines the version of the software the bug was found
> in."
> to
> "The oldest version of the software the bug can be found in.",
>
> Also the help text for "assigned to" should be changed from
> "The person in charge of resolving the ${terms.bug}."
> to
> "The person in charge of progressing the ${terms.bug}."
> because we sometimes need more info, specific testing, etc. from others.
>
This might be confusing, because we have a separate field for "QA
Contact". We've been using that field for the person who is testing
the feature.
Maybe, to be clear, "assigned to" could say something like "The
*developer* in charge of progressing..."
> The help text for "operating system" should be changed from
> "The operating system the $terms.bug was observed on."
> to
> "The operating systems the $terms.bug can be observed on."
> because AOO problems are often impacting multiple platforms.
>
> Since many entries in our bugzilla database are not about bugs, but about
> new features or enhancements I'd also like to use the term "issue" instead
> of "bug", when Bugzilla refers to such an entry.
>
> Herbert
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@openoffice.apache.org
> For additional commands, e-mail: dev-help@openoffice.apache.org
>
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@openoffice.apache.org
For additional commands, e-mail: dev-help@openoffice.apache.org
Re: [Bug 124386] Improve Help for Version Selector
Posted by Herbert Duerr <hd...@apache.org>.
On 11.03.2014 23:16, Andrea Pescetti wrote:
> Herbert Duerr wrote:
>> I'd also like to use the term "issue"
>> instead of "bug", when Bugzilla refers to such an entry.
>
> I agree with the proposed changes in general, and it would be nice if
> Bugzilla still added automatic hyperlinks to "issue 123456" when used in
> a comment (I believe it wasn't working any longer - it worked only for
> the "bug 123456" pattern - some time ago; haven't checked recently).
I'd like that too. But unfortunately this "auto-linkification" [1] isn't
directly configurable. We'd need to write a hook for it [2].
[1] http://www.bugzilla.org/docs/2.20/html/hintsandtips.html
[2] https://bugzilla.mozilla.org/show_bug.cgi?id=364254
But we'll need to provide such a hook a least when we switch to git
because autolinks from bugzilla into the repository are very valuable IMHO.
Herbert
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@openoffice.apache.org
For additional commands, e-mail: dev-help@openoffice.apache.org
Re: [Bug 124386] Improve Help for Version Selector
Posted by Andrea Pescetti <pe...@apache.org>.
Herbert Duerr wrote:
> I'd also like to use the term "issue"
> instead of "bug", when Bugzilla refers to such an entry.
I agree with the proposed changes in general, and it would be nice if
Bugzilla still added automatic hyperlinks to "issue 123456" when used in
a comment (I believe it wasn't working any longer - it worked only for
the "bug 123456" pattern - some time ago; haven't checked recently).
Regards,
Andrea.
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@openoffice.apache.org
For additional commands, e-mail: dev-help@openoffice.apache.org
Re: [Bug 124386] Improve Help for Version Selector
Posted by "Marcus (OOo)" <ma...@wtnet.de>.
Am 03/12/2014 08:40 AM, schrieb Herbert Duerr:
> On 11.03.2014 20:38, Marcus (OOo) wrote:
>> Am 03/11/2014 12:05 PM, schrieb Herbert Duerr:
>>> Members of our QA team requested a clarification of the "Version" field
>>> used in our bugzilla instance. There are other terms that could need
>>> some clarification too.
>>> [...]
>>> The help text for "operating system" should be changed from
>>> "The operating system the $terms.bug was observed on."
>>> to
>>> "The operating systems the $terms.bug can be observed on."
>>> because AOO problems are often impacting multiple platforms.
>>
>> What about to write "All operating systems the ...? Then IMHO it is even
>> more clear that more items can/should be chosen.
>
> Bugzilla's "operating systems" selector currently doesn't allow the
> choice of multiple items. In my experience this is quite sufficient:
> Most bugs/features are platform independent and if not then usually
> either a whole platform family (e.g. "all Windows", "all Unix") or a
> very specific platform (e.g. "Windows Server 2003") are impacted by the
> issue.
OK, maybe not the best wording. ;-)
Sorry for the misunderstanding.
I meant that the user can then understand better that all affected OSs
have to be considered.
If he sees the issue on his WinXP system, then it's likely a "Windows,
"All" issue. So, he should consider to choose this item - to cover all
other Windows OSs, too.
Marcus
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@openoffice.apache.org
For additional commands, e-mail: dev-help@openoffice.apache.org
Re: [Bug 124386] Improve Help for Version Selector
Posted by Herbert Duerr <hd...@apache.org>.
On 11.03.2014 20:38, Marcus (OOo) wrote:
> Am 03/11/2014 12:05 PM, schrieb Herbert Duerr:
>> Members of our QA team requested a clarification of the "Version" field
>> used in our bugzilla instance. There are other terms that could need
>> some clarification too.
>> [...]
>> The help text for "operating system" should be changed from
>> "The operating system the $terms.bug was observed on."
>> to
>> "The operating systems the $terms.bug can be observed on."
>> because AOO problems are often impacting multiple platforms.
>
> What about to write "All operating systems the ...? Then IMHO it is even
> more clear that more items can/should be chosen.
Bugzilla's "operating systems" selector currently doesn't allow the
choice of multiple items. In my experience this is quite sufficient:
Most bugs/features are platform independent and if not then usually
either a whole platform family (e.g. "all Windows", "all Unix") or a
very specific platform (e.g. "Windows Server 2003") are impacted by the
issue.
Herbert
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@openoffice.apache.org
For additional commands, e-mail: dev-help@openoffice.apache.org
Re: [Bug 124386] Improve Help for Version Selector
Posted by "Marcus (OOo)" <ma...@wtnet.de>.
Am 03/11/2014 12:05 PM, schrieb Herbert Duerr:
> Members of our QA team requested a clarification of the "Version" field
> used in our bugzilla instance. There are other terms that could need
> some clarification too.
>
> So before I request ASF-Infra to change our bugzilla installation by
> using the patch [1], I'd like to ask for lazy consensus to request this
> change in our bugzilla installation.
>
> [1] https://issues.apache.org/ooo/attachment.cgi?id=82837&action=diff
>
> In particular the help text for "version" should be changed from
> "The version field defines the version of the software the bug was found
> in."
> to
> "The oldest version of the software the bug can be found in.",
>
> Also the help text for "assigned to" should be changed from
> "The person in charge of resolving the ${terms.bug}."
> to
> "The person in charge of progressing the ${terms.bug}."
> because we sometimes need more info, specific testing, etc. from others.
>
> The help text for "operating system" should be changed from
> "The operating system the $terms.bug was observed on."
> to
> "The operating systems the $terms.bug can be observed on."
> because AOO problems are often impacting multiple platforms.
What about to write "All operating systems the ...? Then IMHO it is even
more clear that more items can/should be chosen.
> Since many entries in our bugzilla database are not about bugs, but
> about new features or enhancements I'd also like to use the term "issue"
> instead of "bug", when Bugzilla refers to such an entry.
+1 to improve the help texts.
Marcus
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@openoffice.apache.org
For additional commands, e-mail: dev-help@openoffice.apache.org
Re: [Bug 124386] Improve Help for Version Selector
Posted by Kay Schenk <ka...@gmail.com>.
On 03/11/2014 04:05 AM, Herbert Duerr wrote:
> Members of our QA team requested a clarification of the "Version" field
> used in our bugzilla instance. There are other terms that could need
> some clarification too.
>
> So before I request ASF-Infra to change our bugzilla installation by
> using the patch [1], I'd like to ask for lazy consensus to request this
> change in our bugzilla installation.
>
> [1] https://issues.apache.org/ooo/attachment.cgi?id=82837&action=diff
>
> In particular the help text for "version" should be changed from
> "The version field defines the version of the software the bug was
> found in."
> to
> "The oldest version of the software the bug can be found in.",
>
> Also the help text for "assigned to" should be changed from
> "The person in charge of resolving the ${terms.bug}."
> to
> "The person in charge of progressing the ${terms.bug}."
> because we sometimes need more info, specific testing, etc. from others.
>
> The help text for "operating system" should be changed from
> "The operating system the $terms.bug was observed on."
> to
> "The operating systems the $terms.bug can be observed on."
> because AOO problems are often impacting multiple platforms.
>
> Since many entries in our bugzilla database are not about bugs, but
> about new features or enhancements I'd also like to use the term "issue"
> instead of "bug", when Bugzilla refers to such an entry.
>
> Herbert
+1 these all look good
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@openoffice.apache.org
> For additional commands, e-mail: dev-help@openoffice.apache.org
>
--
-------------------------------------------------------------------------
MzK
"Cats do not have to be shown how to have a good time,
for they are unfailing ingenious in that respect."
-- James Mason
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@openoffice.apache.org
For additional commands, e-mail: dev-help@openoffice.apache.org
Re: [Bug 124386] Improve Help for Version Selector
Posted by Oliver-Rainer Wittmann <or...@googlemail.com>.
Hi,
On 19.03.2014 09:07, Andre Fischer wrote:
> On 18.03.2014 14:54, Ariel Constenla-Haile wrote:
>> On Tue, Mar 11, 2014 at 12:05:31PM +0100, Herbert Duerr wrote:
>>> Since many entries in our bugzilla database are not about bugs, but
>>> about new features or enhancements I'd also like to use the term
>>> "issue" instead of "bug", when Bugzilla refers to such an entry.
>> Isn't it possible to use both? The recent change turns all "bug XXX"
>> into simple text, for example
>> https://issues.apache.org/ooo/show_bug.cgi?id=124366#c1 used to have
>> a link in "See bug 119006 for more information."
>
> Thanks for bringing this to my attention and thanks to Rainer for
> creating bug/issue 124460 for this. Fooled by the title of the thread I
> did not read the proposed patch carefully enough to see the unrelated
> part about the bug->issue renaming. Could we please discuss or at least
> announce such changes with more meaningful titles in the future?
>
I also did not know that changing the term "bug" to "issue" would cause
that all existing links to issues in Bugzilla comments break/vanish.
+1, for bringing the links back.
Best regards, Oliver.
> -Andre
>
>>
>>
>> Regards
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@openoffice.apache.org
> For additional commands, e-mail: dev-help@openoffice.apache.org
>
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@openoffice.apache.org
For additional commands, e-mail: dev-help@openoffice.apache.org
Re: [Bug 124386] Improve Help for Version Selector
Posted by Andre Fischer <aw...@gmail.com>.
On 18.03.2014 14:54, Ariel Constenla-Haile wrote:
> On Tue, Mar 11, 2014 at 12:05:31PM +0100, Herbert Duerr wrote:
>> Since many entries in our bugzilla database are not about bugs, but
>> about new features or enhancements I'd also like to use the term
>> "issue" instead of "bug", when Bugzilla refers to such an entry.
> Isn't it possible to use both? The recent change turns all "bug XXX"
> into simple text, for example
> https://issues.apache.org/ooo/show_bug.cgi?id=124366#c1 used to have
> a link in "See bug 119006 for more information."
Thanks for bringing this to my attention and thanks to Rainer for
creating bug/issue 124460 for this. Fooled by the title of the thread I
did not read the proposed patch carefully enough to see the unrelated
part about the bug->issue renaming. Could we please discuss or at least
announce such changes with more meaningful titles in the future?
-Andre
>
>
> Regards
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@openoffice.apache.org
For additional commands, e-mail: dev-help@openoffice.apache.org
Re: [Bug 124386] Improve Help for Version Selector
Posted by Herbert Duerr <hd...@apache.org>.
On 18.03.2014 14:54, Ariel Constenla-Haile wrote:
> On Tue, Mar 11, 2014 at 12:05:31PM +0100, Herbert Duerr wrote:
>> Since many entries in our bugzilla database are not about bugs, but
>> about new features or enhancements I'd also like to use the term
>> "issue" instead of "bug", when Bugzilla refers to such an entry.
>
> Isn't it possible to use both? The recent change turns all "bug XXX"
> into simple text, for example
> https://issues.apache.org/ooo/show_bug.cgi?id=124366#c1 used to have
> a link in "See bug 119006 for more information."
As far as I know we'd need to use a bugzilla hook for a more generic
"auto-linkification". The current changes only changed text templates.
Writing the hook seems not too difficult [1] but we haven't gotten
around to it.
[1] https://bugzilla.mozilla.org/show_bug.cgi?id=364254
Herbert
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@openoffice.apache.org
For additional commands, e-mail: dev-help@openoffice.apache.org
Re: [Bug 124386] Improve Help for Version Selector
Posted by Ariel Constenla-Haile <ar...@apache.org>.
On Tue, Mar 11, 2014 at 12:05:31PM +0100, Herbert Duerr wrote:
> Since many entries in our bugzilla database are not about bugs, but
> about new features or enhancements I'd also like to use the term
> "issue" instead of "bug", when Bugzilla refers to such an entry.
Isn't it possible to use both? The recent change turns all "bug XXX"
into simple text, for example
https://issues.apache.org/ooo/show_bug.cgi?id=124366#c1 used to have
a link in "See bug 119006 for more information."
Regards
--
Ariel Constenla-Haile
La Plata, Argentina