When I think of CHANGES.txt, I think of communicating to users.  We
write something succinct for the benefit of users to understand how
this change will impact them.

I don't think of CHANGES.txt as a log of all changes.  I think
increasing the scope to such wastes the time of users (and *we* are
also users!), and dilutes the value of more meaningful entries.

I know we have an "Other" section... perhaps this section allows us to
add stuff that no user ought to care about.  Not sure if users know to
not waste their time looking at it.  Still... I think we shouldn't
bother adding some changes to CHANGES.txt at all.

So... if a deprecated method is replaced with an equivalent... lets
just not add this; okay?  Specific example:  replacing new URL("...")
with the new equivalent.  Honestly I don't even need to ask; just
don't.  Perhaps others have input on other examples or have different
perspectives of thinking about this.  The presence of a JIRA issue
doesn't necessarily mean a CHANGES.txt entry needs to be added.

~ David Smiley
Apache Lucene/Solr Search Developer
http://www.linkedin.com/in/davidwsmiley

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

Reply via email to