[jira] [Commented] (LUCENE-4943) remove 'Changes to Backwards Compatibility Policy' from lucene/CHANGES.txt

["Uwe Schindler (JIRA)" <ji...@apache.org>]

    [ https://issues.apache.org/jira/browse/LUCENE-4943?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13636350#comment-13636350 ] 

Uwe Schindler commented on LUCENE-4943:
---------------------------------------

+1 to have a better upgrading section (and the original issues just spread around the other sections like API changes, new Features,...), but we have it somehow already: MIGRATE.txt (currently it only contains migration to 4.0 (or 5.0 on trunk).
                
> remove 'Changes to Backwards Compatibility Policy' from lucene/CHANGES.txt
> --------------------------------------------------------------------------
>
>                 Key: LUCENE-4943
>                 URL: https://issues.apache.org/jira/browse/LUCENE-4943
>             Project: Lucene - Core
>          Issue Type: Bug
>            Reporter: Robert Muir
>             Fix For: 4.4
>
>
> CHANGES.txt is useful to summarize the changes in a release. 
> However its expected that a lot of changes will impact the APIs, this currently hurts the quality of CHANGES.txt because it leads to a significant portion of changes (whether they be bugs, features, whatever) being grouped under this one title.
> It also leads to descriptions of CHANGES being unnecessarily verbose.
> I think it makes CHANGES confusing and overwhelming, and it would be better to have a simpler 'upgrading' section with practical information on what you actually need to do (like Solr's CHANGES.txt).

--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators
For more information on JIRA, see: http://www.atlassian.com/software/jira

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@lucene.apache.org
For additional commands, e-mail: dev-help@lucene.apache.org