On 21/06/2011 07:21, Konstantin Kolinko wrote:
> 2011/6/21 Rainer Jung <rainer.j...@kippdata.de>:
>> On 21.06.2011 00:28, ma...@apache.org wrote:
>>> Author: markt
>>> Date: Mon Jun 20 22:28:57 2011
>>> New Revision: 1137803
>>>
>>> URL: http://svn.apache.org/viewvc?rev=1137803&view=rev
>>> Log:
>>> Ordering
>>>
>>> Modified:
>>>     tomcat/trunk/webapps/docs/changelog.xml
>>
>> I always forget whether there's a standard (I would like to have one):
>>
>> - Ordering of sections: OK, defined by comment in changelog
>> - Ordering inside section:
>>  - chronological (oldest first or last)?
>>  - first by add, update, fix (in which order?)
>>    and then chronological (oldest first or last)?
>>
>> If the rule is clear, I can add it as another comment into the file.
>>
>> Who knows the rules?
> 
> Fixes having an issue number are sorted by their number, ascending.
> That is the only strict rule.
> 
> There is no ordering by add/update/fix.
> 
> Other fixed issues are added to the end of the list, chronologically.
> They eventually become mixed with the numbered issues. (I.e., numbered
> issues to not "pop up" wrt. others).

Very succinctly put. That is what I have been doing for Tomcat 7 in a
nutshell.

Mark



---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscr...@tomcat.apache.org
For additional commands, e-mail: dev-h...@tomcat.apache.org

Reply via email to