harmony-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Ivanov, Alexey A" <alexey.a.iva...@intel.com>
Subject RE: [jira] Good issue resolution guideline (was: [classlib]volunteer to supply patches for old JIRAs)
Date Wed, 08 Nov 2006 12:47:30 GMT
>-----Original Message-----
>From: Konovalova, Svetlana [mailto:svetlana.konovalova@intel.com]
>Sent: Wednesday, November 08, 2006 3:24 PM
>To: harmony-dev@incubator.apache.org
>Subject: RE: [jira] Good issue resolution guideline (was:
>[classlib]volunteer to supply patches for old JIRAs)
>
>Alexey wrote:
>>Do we really need a smiley in the header: "Resolution Provider :)"?
>
>Of course not, since it's not just a friendly correspondence:) suggest
>to remove.

+1

>
>>AFAIK, for headings one should use Title Capitalization, i.e. first
>>letter of each word is capitalized with exception for articles,
>>prepositions, and conjunctions. Or am I wrong?
>
>You are absolutely right here.
>
>>And another comment. Will it be better to use different numbering in
>>lists? I mean like this:
>>1. Issue is probably a non-bug...
>>	a. Discuss on dev-list.
>>	b. Add a link...
>>2. Issue is a bug:
>>	a. Notify the community...
>>	b. If reporter did not provide a patch to test...
>
>I, personally, do not see any reason why not to use different
numbering.
>For such complex lists, we usually use numbers for the first level and
>bullets for the second one.

I don't mind using bullets. However, numbered lists are good for
referring: you can just say 1.a. On the other hand, since we agreed on
this guideline, I see nothing which stops us from making nested lists
bulleted.

>Speaking about the "Good issue resolution guideline" page, I'd rewrite
>it to get rid of complex lists and to avoid a sort of confusion:
>
>If the issue is not a bug, ...:
>   1. Discuss on dev-list.
>   2. Add a link...
>
>If the issue is a bug,...:
>   1. Notify the community...
>   2. If reporter did not provide a patch to test...
>
>What would you say?

That's fine with me. Maybe just add some styling, so that "If the issue
is not a bug,..." and "If the issue is a bug..." stand out, using bold
for example.

>
>By the way, I'm going to create a patch to add links from the website
>to this page. If you do not mind, I can correct the page as well in
>between times... how about that?

Great!


By the way there's another problem with the page: it has misplaced </li>
in the first item below the heading "Issue reporter". (So that some text
belongs to <ol> itself.) This makes the list look weirdly in Mozilla
Firefox whereas IE handles this error.


Regards,
Alexey.

>
>Best regards,
>Sveta Konovalova
>
>-----Original Message-----
>From: Ivanov, Alexey A [mailto:alexey.a.ivanov@intel.com]
>Sent: Wednesday, November 08, 2006 1:50 PM
>To: harmony-dev@incubator.apache.org
>Subject: RE: [jira] Good issue resolution guideline (was:
>[classlib]volunteer to supply patches for old JIRAs)
>
>Hi,
>
>Do we really need a smiley in the header: "Resolution Provider :)"?
>
>AFAIK, for headings one should use Title Capitalization, i.e. first
>letter of each word is capitalized with exception for articles,
>prepositions, and conjunctions. Or am I wrong?
>
>Does anyone mind to mark up file names (build.xml) and paths
>(https://svn.apache.org/...) in monospaced font using <code> tags?
>
>Is it worth making repository path a link?
>
>And another comment. Will it be better to use different numbering in
>lists? I mean like this:
>1. Issue is probably a non-bug...
>	a. Discuss on dev-list.
>	b. Add a link...
>2. Issue is a bug:
>	a. Notify the community...
>	b. If reporter did not provide a patch to test...
>
>
>Any comments?
>
>
>Regards,
>--
>Alexey A. Ivanov
>Intel Middleware Product Division
>
>
>>-----Original Message-----
>>From: Alexey Petrenko [mailto:alexey.a.petrenko@gmail.com]
>>Sent: Tuesday, November 07, 2006 1:32 PM
>>To: harmony-dev@incubator.apache.org
>>Subject: Re: [jira] Good issue resolution guideline (was:
>>[classlib]volunteer to supply patches for old JIRAs)
>>
>>I've published "Good issue resolution guideline" on Harmony site:
>>http://incubator.apache.org/harmony/issue_resolution_guideline.html
>>(wait for a while for the web site synchronization). It is not linked
>>to other pages yet.
>>
>>So comments to guideline and link place suggestions are welcome.
>>
>>SY, Alexey
>>

<SNIP>

--
Alexey A. Ivanov
Intel Middleware Product Division

Mime
View raw message