You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@lucene.apache.org by Chris Hostetter <ho...@fucit.org> on 2010/05/25 20:34:25 UTC

Solr version housekeeping in Jira/Wiki (1.5, 1.6, 3.x, 4.x, etc...)

A while back, after the trunk merge (but before the 3x branch fork) yonik 
and i spear-headed a healthy depate on the list about whether the next 
version of Solr should have a lock-step version number with Lucene ... 
while i've generally come arround to yonik's way of thinking, that's *not* 
what this thread is about (i say that up front in the hopes of preventing 
this thread from devolving into a continued debate about internal vs 
marketing version numbers)

Independent of the questions of what branch the next version of SOlr 
should be released on, or what version number "label" it should be called, 
is the issue of keeping straight what bug fixes and features have been 
added to what branches.  Several issues in Jira were marked as "Fixed" in 
1.5, prior to the trunk merge but with the ambiguity about how the 
versioning was going to evlove, were never bulk updated to indicate that 
they were actaully going be fixed in 3.1 (or 4.0).  Now that we may (or 
may not) ever have a 1.5 release, it can be hard to look at a Jira issue 
and make sense of where the chnages were actually commited.  This has been 
componded by some committers (i take responsibility for being the majority 
of the problem) continuing to mark issues they commit as being fixed in 
"1.5" even though they commited to the "trunk" (after the lucene/solr 
trunk merge)

Likewise for the way we annotate information in the Solr wiki.  Several 
bits of documentation are annoated as being in 1.5, but nothing is marked 
as 3.1 or 4.1

What i'd like to propose is that we focus on making sure the 
"Fix Version" in Jira and the annotations on the wiki correctly reflect 
the "next" version of the *branches* where changes have been commited. 
Even if (in the unlikely event) the final version numbers that we 
release are ultimatley differnet, we can at least be reasonably confident 
that a simple batch replace will work.

In concrete terms, these are the steps i'm planning to take in a few days 
unless someone objects, or suggests a simpler path...

1) create a new Jira version for Solr called "next" as a way to track 
unresolved issues that people generally feel should be fixed in the "next" 
feature release.

2) bulk change any Solr issue currently UNRESOLVED with a "Fix Version" or 
1.5, 1.6, 3.1, or 4.0 so that it's new Fix Version is "next"

3) Compute three diffs, one for each of each of these three 
CHANGES.txt files...

http://svn.apache.org/viewvc/lucene/solr/branches/branch-1.5-dev/CHANGES.txt
http://svn.apache.org/viewvc/lucene/dev/branches/branch_3x/solr/CHANGES.txt
http://svn.apache.org/viewvc/lucene/dev/trunk/solr/CHANGES.txt
 	...against the official 1.4 CHANGES.txt...
http://svn.apache.org/viewvc/lucene/solr/tags/release-1.4.0/CHANGES.txt

4) merge the diffs from step#3 into a 4 column report, listing every issue 
mentioned in any of those three CHANGES.txt files and which "branches" it 
has been commited to.

5) using the report for step#4, manually update every individual issue so 
that the Fix Version accurately the list of *possible* versions that issue 
will be fixed in, if there is a release off of those respective branches 
(ie: some subset of (1.5, 3.1, 4.0))

6) delete "1.6" as a Solr version in Jira.

7) Update the Solr1.5 wiki page to link to the 1.5 branch in SVN, and add 
a note that such a release may never actually happen... 
http://wiki.apache.org/solr/Solr1.5

8) Create new wiki pages for Solr3.1 and Solr4.0, model them after the 
Solr1.5 page with pointers to what branch of SVN development is taking 
place on and where to track issues fixed on those branches.  (we can also 
add verbage here about the merged lucene/solr dev model, and why the 3x 
branch was created, but we can worry about that later)

9) Audit every link to the Solr1.5 page, and add links to the new Solr3.1 
and Solr4.0 pages as needed...
http://wiki.apache.org/solr/Solr1.5?action=fullsearch&context=180&value=linkto%3A%22Solr1.5%22


...I'm not particularly looking forward to step #5, but it's the only safe 
way i can thin of to make everything is correct.  I'm open to other 
suggestions.


-Hoss


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


Re: Solr version housekeeping in Jira/Wiki (1.5, 1.6, 3.x, 4.x, etc...)

Posted by Chris Hostetter <ho...@fucit.org>.
Steps #1, #2, and #6 have been completed.  

The full list of issues affected by Step #2 can be located using a Jira 
search for "hossversioncleanup20100527" in comments.

: 1) create a new Jira version for Solr called "next" as a way to track
: unresolved issues that people generally feel should be fixed in the "next"
: feature release.

: 2) bulk change any Solr issue currently UNRESOLVED with a "Fix Version" or
: 1.5, 1.6, 3.1, or 4.0 so that it's new Fix Version is "next"

: 6) delete "1.6" as a Solr version in Jira.



-Hoss


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


Re: Solr version housekeeping in Jira/Wiki (1.5, 1.6, 3.x, 4.x, etc...)

Posted by Chris Hostetter <ho...@fucit.org>.
#7 and #8 are done...

: 7) Update the Solr1.5 wiki page to link to the 1.5 branch in SVN, and add a
: note that such a release may never actually happen...
: http://wiki.apache.org/solr/Solr1.5
: 
: 8) Create new wiki pages for Solr3.1 and Solr4.0, model them after the Solr1.5
: page with pointers to what branch of SVN development is taking place on and
: where to track issues fixed on those branches.  (we can also add verbage here
: about the merged lucene/solr dev model, and why the 3x branch was created, but
: we can worry about that later)

-Hoss


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


Re: Solr version housekeeping in Jira/Wiki (1.5, 1.6, 3.x, 4.x, etc...)

Posted by Chris Hostetter <ho...@fucit.org>.
: 9) Audit every link to the Solr1.5 page, and add links to the new Solr3.1 and
: Solr4.0 pages as needed...
: http://wiki.apache.org/solr/Solr1.5?action=fullsearch&context=180&value=linkto%3A%22Solr1.5%22

To be clear, my goal here isn't to add a link to the 3.1 and 4.0 pages 
for every existing 1.5 link -- my goal is to make sure that if there's a 
link to "Solr1.5", the feature in question really is on the 1.5 branch.
if it's not, if it's only on the 3x and trunk, then link it to "Solr3.1" 
... if it's only on trunk, link it to "Solr4.0" (ie: the earliest version 
where the feature exists)

if/when we decide the 1.5 branch is officially dead, we can do a big bulk 
edit of s/Solr1.5/Solr3.1/g ... likewise if 3.1 never actually happens and 
we just release from trunk s/Solr3.1/Solr4.0/g

Having said that -- I'M DONE!

There were ~18 wiki pages with links to "Solr1.5" -- I've audieted 
all of them and updated all links to Solr1.5 where the functionality 
wasnt' actually o nthe 1.5 branch (most were trivial to verify/fix 
based on the CHANGES.txt diffs i had) .. in the cases where the wiki page 
was describing something that currently only exists in patch form, and 
isn't on any branch yet, i linked to Solr4.0.




Let's try to avoid ever needing to do anything like this again.



-Hoss


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


Re: Solr version housekeeping in Jira/Wiki (1.5, 1.6, 3.x, 4.x, etc...)

Posted by "Mattmann, Chris A (388J)" <ch...@jpl.nasa.gov>.
Good job, Hoss!

Cheers,
Chris


On 5/27/10 4:28 PM, "Chris Hostetter" <ho...@fucit.org> wrote:

:       ...and here's the final contents of all.fixed.txt...

Checkpoint: going sequentially down the list, i've manually fixed
everything up to an including SOLR-1611.  (only 66 left, woot!) ... i'll
finish up hte rest after dinner.

:
: https://issues.apache.org/jira/browse/SOLR-1131       1.5     3.1     4.0
: https://issues.apache.org/jira/browse/SOLR-1139       1.5     3.1     4.0
: https://issues.apache.org/jira/browse/SOLR-1177       1.5     3.1     4.0
: https://issues.apache.org/jira/browse/SOLR-1268       1.5     3.1     4.0
: https://issues.apache.org/jira/browse/SOLR-1297       1.5     3.1     4.0
: https://issues.apache.org/jira/browse/SOLR-1302       1.5     3.1     4.0
: https://issues.apache.org/jira/browse/SOLR-1357       1.5     3.1     4.0
: https://issues.apache.org/jira/browse/SOLR-1379       3.1     4.0
: https://issues.apache.org/jira/browse/SOLR-1432       1.5     3.1     4.0
: https://issues.apache.org/jira/browse/SOLR-1516       1.5     3.1     4.0
: https://issues.apache.org/jira/browse/SOLR-1522       1.5     3.1     4.0
: https://issues.apache.org/jira/browse/SOLR-1532       1.5     3.1     4.0
: https://issues.apache.org/jira/browse/SOLR-1538       1.5     3.1     4.0
: https://issues.apache.org/jira/browse/SOLR-1553       1.5     3.1     4.0
: https://issues.apache.org/jira/browse/SOLR-1558       1.5     3.1     4.0
: https://issues.apache.org/jira/browse/SOLR-1561       1.5     3.1     4.0
: https://issues.apache.org/jira/browse/SOLR-1563       1.5     3.1     4.0
: https://issues.apache.org/jira/browse/SOLR-1569       1.5     3.1     4.0
: https://issues.apache.org/jira/browse/SOLR-1570       1.5     3.1     4.0
: https://issues.apache.org/jira/browse/SOLR-1571       1.5     3.1     4.0
: https://issues.apache.org/jira/browse/SOLR-1572       1.5     3.1     4.0
: https://issues.apache.org/jira/browse/SOLR-1574       1.5     3.1     4.0
: https://issues.apache.org/jira/browse/SOLR-1577       1.5     3.1     4.0
: https://issues.apache.org/jira/browse/SOLR-1579       1.5     3.1     4.0
: https://issues.apache.org/jira/browse/SOLR-1580       1.5     3.1     4.0
: https://issues.apache.org/jira/browse/SOLR-1582       1.5     3.1     4.0
: https://issues.apache.org/jira/browse/SOLR-1584       1.5     3.1     4.0
: https://issues.apache.org/jira/browse/SOLR-1586       1.5     3.1     4.0
: https://issues.apache.org/jira/browse/SOLR-1587       1.5     3.1     4.0
: https://issues.apache.org/jira/browse/SOLR-1588       1.5     3.1     4.0
: https://issues.apache.org/jira/browse/SOLR-1590       1.5     3.1     4.0
: https://issues.apache.org/jira/browse/SOLR-1592       1.5     3.1     4.0
: https://issues.apache.org/jira/browse/SOLR-1593       1.5     3.1     4.0
: https://issues.apache.org/jira/browse/SOLR-1595       1.5     3.1     4.0
: https://issues.apache.org/jira/browse/SOLR-1596       1.5     3.1     4.0
: https://issues.apache.org/jira/browse/SOLR-1601       1.5     3.1     4.0
: https://issues.apache.org/jira/browse/SOLR-1608       1.5     3.1     4.0
: https://issues.apache.org/jira/browse/SOLR-1610       1.5     3.1     4.0
: https://issues.apache.org/jira/browse/SOLR-1611       1.5     3.1     4.0
: https://issues.apache.org/jira/browse/SOLR-1615       1.5     3.1     4.0
: https://issues.apache.org/jira/browse/SOLR-1621       1.5     3.1     4.0
: https://issues.apache.org/jira/browse/SOLR-1624       1.5     3.1     4.0
: https://issues.apache.org/jira/browse/SOLR-1625       1.5     3.1     4.0
: https://issues.apache.org/jira/browse/SOLR-1628       1.5     3.1     4.0
: https://issues.apache.org/jira/browse/SOLR-1635       1.5     3.1     4.0
: https://issues.apache.org/jira/browse/SOLR-1637       1.5     3.1     4.0
: https://issues.apache.org/jira/browse/SOLR-1651       1.5     3.1     4.0
: https://issues.apache.org/jira/browse/SOLR-1653       1.5     3.1     4.0
: https://issues.apache.org/jira/browse/SOLR-1657       3.1     4.0
: https://issues.apache.org/jira/browse/SOLR-1660       1.5     3.1     4.0
: https://issues.apache.org/jira/browse/SOLR-1661       1.5     3.1     4.0
: https://issues.apache.org/jira/browse/SOLR-1662       1.5     3.1     4.0
: https://issues.apache.org/jira/browse/SOLR-1667       1.5     3.1     4.0
: https://issues.apache.org/jira/browse/SOLR-1674       1.5     3.1     4.0
: https://issues.apache.org/jira/browse/SOLR-1677       3.1     4.0
: https://issues.apache.org/jira/browse/SOLR-1679       1.5     3.1     4.0
: https://issues.apache.org/jira/browse/SOLR-1695       1.5     3.1     4.0
: https://issues.apache.org/jira/browse/SOLR-1696       1.5     3.1     4.0
: https://issues.apache.org/jira/browse/SOLR-1697       1.5     3.1     4.0
: https://issues.apache.org/jira/browse/SOLR-1704       1.5     3.1     4.0
: https://issues.apache.org/jira/browse/SOLR-1706       3.1     4.0
: https://issues.apache.org/jira/browse/SOLR-1711       1.5     3.1     4.0
: https://issues.apache.org/jira/browse/SOLR-1722       1.5     3.1     4.0
: https://issues.apache.org/jira/browse/SOLR-1727       1.5     3.1     4.0
: https://issues.apache.org/jira/browse/SOLR-1736       1.5     3.1     4.0
: https://issues.apache.org/jira/browse/SOLR-1740       3.1     4.0
: https://issues.apache.org/jira/browse/SOLR-1744       1.5     3.1     4.0
: https://issues.apache.org/jira/browse/SOLR-1745       1.5     3.1     4.0
: https://issues.apache.org/jira/browse/SOLR-1746       1.5     3.1     4.0
: https://issues.apache.org/jira/browse/SOLR-1747       1.5     3.1     4.0
: https://issues.apache.org/jira/browse/SOLR-1748       1.5     3.1     4.0
: https://issues.apache.org/jira/browse/SOLR-1750       1.5     3.1     4.0
: https://issues.apache.org/jira/browse/SOLR-1753       1.5     3.1     4.0
: https://issues.apache.org/jira/browse/SOLR-1769       3.1     4.0
: https://issues.apache.org/jira/browse/SOLR-1771       1.5     3.1     4.0
: https://issues.apache.org/jira/browse/SOLR-1776       1.5     3.1     4.0
: https://issues.apache.org/jira/browse/SOLR-1777       1.5     3.1     4.0
: https://issues.apache.org/jira/browse/SOLR-1792       1.5     3.1     4.0
: https://issues.apache.org/jira/browse/SOLR-1797       1.5     3.1     4.0
: https://issues.apache.org/jira/browse/SOLR-1798       1.5     3.1     4.0
: https://issues.apache.org/jira/browse/SOLR-1815       1.5     3.1     4.0
: https://issues.apache.org/jira/browse/SOLR-1821       1.5     3.1     4.0
: https://issues.apache.org/jira/browse/SOLR-1823       1.5     3.1     4.0
: https://issues.apache.org/jira/browse/SOLR-1824       4.0
: https://issues.apache.org/jira/browse/SOLR-1843       4.0
: https://issues.apache.org/jira/browse/SOLR-1845       3.1     4.0
: https://issues.apache.org/jira/browse/SOLR-1846       4.0
: https://issues.apache.org/jira/browse/SOLR-1850       3.1     4.0
: https://issues.apache.org/jira/browse/SOLR-1851       4.0
: https://issues.apache.org/jira/browse/SOLR-1857       3.1     4.0
: https://issues.apache.org/jira/browse/SOLR-1865       3.1     4.0
: https://issues.apache.org/jira/browse/SOLR-1874       3.1     4.0
: https://issues.apache.org/jira/browse/SOLR-1875       4.0
: https://issues.apache.org/jira/browse/SOLR-1876       3.1     4.0
: https://issues.apache.org/jira/browse/SOLR-1891       3.1     4.0
: https://issues.apache.org/jira/browse/SOLR-1902       4.0
: https://issues.apache.org/jira/browse/SOLR-1904       4.0
: https://issues.apache.org/jira/browse/SOLR-1908       4.0
: https://issues.apache.org/jira/browse/SOLR-1923       3.1     4.0
: https://issues.apache.org/jira/browse/SOLR-1928       4.0
: https://issues.apache.org/jira/browse/SOLR-343        1.5     3.1     4.0
: https://issues.apache.org/jira/browse/SOLR-397        4.0
: https://issues.apache.org/jira/browse/SOLR-571        4.0
: https://issues.apache.org/jira/browse/SOLR-785        1.5     3.1     4.0
: https://issues.apache.org/jira/browse/SOLR-945        4.0
:
: ---------------------------------------------------------------------
: To unsubscribe, e-mail: dev-unsubscribe@lucene.apache.org
: For additional commands, e-mail: dev-help@lucene.apache.org
:



-Hoss


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




++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
Chris Mattmann, Ph.D.
Senior Computer Scientist
NASA Jet Propulsion Laboratory Pasadena, CA 91109 USA
Office: 171-266B, Mailstop: 171-246
Email: Chris.Mattmann@jpl.nasa.gov
WWW:   http://sunset.usc.edu/~mattmann/
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
Adjunct Assistant Professor, Computer Science Department
University of Southern California, Los Angeles, CA 90089 USA
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++


Re: Solr version housekeeping in Jira/Wiki (1.5, 1.6, 3.x, 4.x, etc...)

Posted by Chris Hostetter <ho...@fucit.org>.
: 	...and here's the final contents of all.fixed.txt...

Checkpoint: going sequentially down the list, i've manually fixed 
everything up to an including SOLR-1611.  (only 66 left, woot!) ... i'll 
finish up hte rest after dinner.

: 
: https://issues.apache.org/jira/browse/SOLR-1131	1.5	3.1	4.0
: https://issues.apache.org/jira/browse/SOLR-1139	1.5	3.1	4.0
: https://issues.apache.org/jira/browse/SOLR-1177	1.5	3.1	4.0
: https://issues.apache.org/jira/browse/SOLR-1268	1.5	3.1	4.0
: https://issues.apache.org/jira/browse/SOLR-1297	1.5	3.1	4.0
: https://issues.apache.org/jira/browse/SOLR-1302	1.5	3.1	4.0
: https://issues.apache.org/jira/browse/SOLR-1357	1.5	3.1	4.0
: https://issues.apache.org/jira/browse/SOLR-1379	3.1	4.0
: https://issues.apache.org/jira/browse/SOLR-1432	1.5	3.1	4.0
: https://issues.apache.org/jira/browse/SOLR-1516	1.5	3.1	4.0
: https://issues.apache.org/jira/browse/SOLR-1522	1.5	3.1	4.0
: https://issues.apache.org/jira/browse/SOLR-1532	1.5	3.1	4.0
: https://issues.apache.org/jira/browse/SOLR-1538	1.5	3.1	4.0
: https://issues.apache.org/jira/browse/SOLR-1553	1.5	3.1	4.0
: https://issues.apache.org/jira/browse/SOLR-1558	1.5	3.1	4.0
: https://issues.apache.org/jira/browse/SOLR-1561	1.5	3.1	4.0
: https://issues.apache.org/jira/browse/SOLR-1563	1.5	3.1	4.0
: https://issues.apache.org/jira/browse/SOLR-1569	1.5	3.1	4.0
: https://issues.apache.org/jira/browse/SOLR-1570	1.5	3.1	4.0
: https://issues.apache.org/jira/browse/SOLR-1571	1.5	3.1	4.0
: https://issues.apache.org/jira/browse/SOLR-1572	1.5	3.1	4.0
: https://issues.apache.org/jira/browse/SOLR-1574	1.5	3.1	4.0
: https://issues.apache.org/jira/browse/SOLR-1577	1.5	3.1	4.0
: https://issues.apache.org/jira/browse/SOLR-1579	1.5	3.1	4.0
: https://issues.apache.org/jira/browse/SOLR-1580	1.5	3.1	4.0
: https://issues.apache.org/jira/browse/SOLR-1582	1.5	3.1	4.0
: https://issues.apache.org/jira/browse/SOLR-1584	1.5	3.1	4.0
: https://issues.apache.org/jira/browse/SOLR-1586	1.5	3.1	4.0
: https://issues.apache.org/jira/browse/SOLR-1587	1.5	3.1	4.0
: https://issues.apache.org/jira/browse/SOLR-1588	1.5	3.1	4.0
: https://issues.apache.org/jira/browse/SOLR-1590	1.5	3.1	4.0
: https://issues.apache.org/jira/browse/SOLR-1592	1.5	3.1	4.0
: https://issues.apache.org/jira/browse/SOLR-1593	1.5	3.1	4.0
: https://issues.apache.org/jira/browse/SOLR-1595	1.5	3.1	4.0
: https://issues.apache.org/jira/browse/SOLR-1596	1.5	3.1	4.0
: https://issues.apache.org/jira/browse/SOLR-1601	1.5	3.1	4.0
: https://issues.apache.org/jira/browse/SOLR-1608	1.5	3.1	4.0
: https://issues.apache.org/jira/browse/SOLR-1610	1.5	3.1	4.0
: https://issues.apache.org/jira/browse/SOLR-1611	1.5	3.1	4.0
: https://issues.apache.org/jira/browse/SOLR-1615	1.5	3.1	4.0
: https://issues.apache.org/jira/browse/SOLR-1621	1.5	3.1	4.0
: https://issues.apache.org/jira/browse/SOLR-1624	1.5	3.1	4.0
: https://issues.apache.org/jira/browse/SOLR-1625	1.5	3.1	4.0
: https://issues.apache.org/jira/browse/SOLR-1628	1.5	3.1	4.0
: https://issues.apache.org/jira/browse/SOLR-1635	1.5	3.1	4.0
: https://issues.apache.org/jira/browse/SOLR-1637	1.5	3.1	4.0
: https://issues.apache.org/jira/browse/SOLR-1651	1.5	3.1	4.0
: https://issues.apache.org/jira/browse/SOLR-1653	1.5	3.1	4.0
: https://issues.apache.org/jira/browse/SOLR-1657	3.1	4.0
: https://issues.apache.org/jira/browse/SOLR-1660	1.5	3.1	4.0
: https://issues.apache.org/jira/browse/SOLR-1661	1.5	3.1	4.0
: https://issues.apache.org/jira/browse/SOLR-1662	1.5	3.1	4.0
: https://issues.apache.org/jira/browse/SOLR-1667	1.5	3.1	4.0
: https://issues.apache.org/jira/browse/SOLR-1674	1.5	3.1	4.0
: https://issues.apache.org/jira/browse/SOLR-1677	3.1	4.0
: https://issues.apache.org/jira/browse/SOLR-1679	1.5	3.1	4.0
: https://issues.apache.org/jira/browse/SOLR-1695	1.5	3.1	4.0
: https://issues.apache.org/jira/browse/SOLR-1696	1.5	3.1	4.0
: https://issues.apache.org/jira/browse/SOLR-1697	1.5	3.1	4.0
: https://issues.apache.org/jira/browse/SOLR-1704	1.5	3.1	4.0
: https://issues.apache.org/jira/browse/SOLR-1706	3.1	4.0
: https://issues.apache.org/jira/browse/SOLR-1711	1.5	3.1	4.0
: https://issues.apache.org/jira/browse/SOLR-1722	1.5	3.1	4.0
: https://issues.apache.org/jira/browse/SOLR-1727	1.5	3.1	4.0
: https://issues.apache.org/jira/browse/SOLR-1736	1.5	3.1	4.0
: https://issues.apache.org/jira/browse/SOLR-1740	3.1	4.0
: https://issues.apache.org/jira/browse/SOLR-1744	1.5	3.1	4.0
: https://issues.apache.org/jira/browse/SOLR-1745	1.5	3.1	4.0
: https://issues.apache.org/jira/browse/SOLR-1746	1.5	3.1	4.0
: https://issues.apache.org/jira/browse/SOLR-1747	1.5	3.1	4.0
: https://issues.apache.org/jira/browse/SOLR-1748	1.5	3.1	4.0
: https://issues.apache.org/jira/browse/SOLR-1750	1.5	3.1	4.0
: https://issues.apache.org/jira/browse/SOLR-1753	1.5	3.1	4.0
: https://issues.apache.org/jira/browse/SOLR-1769	3.1	4.0
: https://issues.apache.org/jira/browse/SOLR-1771	1.5	3.1	4.0
: https://issues.apache.org/jira/browse/SOLR-1776	1.5	3.1	4.0
: https://issues.apache.org/jira/browse/SOLR-1777	1.5	3.1	4.0
: https://issues.apache.org/jira/browse/SOLR-1792	1.5	3.1	4.0
: https://issues.apache.org/jira/browse/SOLR-1797	1.5	3.1	4.0
: https://issues.apache.org/jira/browse/SOLR-1798	1.5	3.1	4.0
: https://issues.apache.org/jira/browse/SOLR-1815	1.5	3.1	4.0
: https://issues.apache.org/jira/browse/SOLR-1821	1.5	3.1	4.0
: https://issues.apache.org/jira/browse/SOLR-1823	1.5	3.1	4.0
: https://issues.apache.org/jira/browse/SOLR-1824	4.0
: https://issues.apache.org/jira/browse/SOLR-1843	4.0
: https://issues.apache.org/jira/browse/SOLR-1845	3.1	4.0
: https://issues.apache.org/jira/browse/SOLR-1846	4.0
: https://issues.apache.org/jira/browse/SOLR-1850	3.1	4.0
: https://issues.apache.org/jira/browse/SOLR-1851	4.0
: https://issues.apache.org/jira/browse/SOLR-1857	3.1	4.0
: https://issues.apache.org/jira/browse/SOLR-1865	3.1	4.0
: https://issues.apache.org/jira/browse/SOLR-1874	3.1	4.0
: https://issues.apache.org/jira/browse/SOLR-1875	4.0
: https://issues.apache.org/jira/browse/SOLR-1876	3.1	4.0
: https://issues.apache.org/jira/browse/SOLR-1891	3.1	4.0
: https://issues.apache.org/jira/browse/SOLR-1902	4.0
: https://issues.apache.org/jira/browse/SOLR-1904	4.0
: https://issues.apache.org/jira/browse/SOLR-1908	4.0
: https://issues.apache.org/jira/browse/SOLR-1923	3.1	4.0
: https://issues.apache.org/jira/browse/SOLR-1928	4.0
: https://issues.apache.org/jira/browse/SOLR-343	1.5	3.1	4.0
: https://issues.apache.org/jira/browse/SOLR-397	4.0
: https://issues.apache.org/jira/browse/SOLR-571	4.0
: https://issues.apache.org/jira/browse/SOLR-785	1.5	3.1	4.0
: https://issues.apache.org/jira/browse/SOLR-945	4.0
: 
: ---------------------------------------------------------------------
: To unsubscribe, e-mail: dev-unsubscribe@lucene.apache.org
: For additional commands, e-mail: dev-help@lucene.apache.org
: 



-Hoss


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


Re: Solr version housekeeping in Jira/Wiki (1.5, 1.6, 3.x, 4.x, etc...)

Posted by Chris Hostetter <ho...@fucit.org>.
: 3) Compute three diffs, one for each of each of these three CHANGES.txt
: files...
	...
: 4) merge the diffs from step#3 into a 4 column report, listing every issue
: mentioned in any of those three CHANGES.txt files and which "branches" it has
: been commited to.

Below is the report generated from those diffs, the sequence of commands 
was...

curl http://svn.apache.org/repos/asf/lucene/solr/tags/release-1.4.0/CHANGES.txt > 1.4.txt
curl http://svn.apache.org/repos/asf/lucene/solr/branches/branch-1.5-dev/CHANGES.txt > 1.5.txt
curl http://svn.apache.org/repos/asf/lucene/dev/branches/branch_3x/solr/CHANGES.txt > 3.1.txt
curl http://svn.apache.org/repos/asf/lucene/dev/trunk/solr/CHANGES.txt > 4.0.txt
 
diff 1.4.txt 1.5.txt > 1.5.diff
diff 1.4.txt 3.1.txt > 3.1.diff
diff 1.4.txt 4.0.txt > 4.0.diff

perl -nle 'print "https://issues.apache.org/jira/browse/$1\t1.5" while /(SOLR-\d+)/g' 1.5.diff | sort -u > 1.5.fixed.txt
perl -nle 'print "https://issues.apache.org/jira/browse/$1\t3.1" while /(SOLR-\d+)/g' 3.1.diff | sort -u > 3.1.fixed.txt
perl -nle 'print "https://issues.apache.org/jira/browse/$1\t4.0" while /(SOLR-\d+)/g' 4.0.diff | sort -u > 4.0.fixed.txt

join -t $'\t' -a 1 -a 2 1.5.fixed.txt 3.1.fixed.txt > tmp.txt
join -t $'\t' -a 1 -a 2 tmp.txt 4.0.fixed.txt > all.fixed.txt

	...and here's the final contents of all.fixed.txt...

https://issues.apache.org/jira/browse/SOLR-1131	1.5	3.1	4.0
https://issues.apache.org/jira/browse/SOLR-1139	1.5	3.1	4.0
https://issues.apache.org/jira/browse/SOLR-1177	1.5	3.1	4.0
https://issues.apache.org/jira/browse/SOLR-1268	1.5	3.1	4.0
https://issues.apache.org/jira/browse/SOLR-1297	1.5	3.1	4.0
https://issues.apache.org/jira/browse/SOLR-1302	1.5	3.1	4.0
https://issues.apache.org/jira/browse/SOLR-1357	1.5	3.1	4.0
https://issues.apache.org/jira/browse/SOLR-1379	3.1	4.0
https://issues.apache.org/jira/browse/SOLR-1432	1.5	3.1	4.0
https://issues.apache.org/jira/browse/SOLR-1516	1.5	3.1	4.0
https://issues.apache.org/jira/browse/SOLR-1522	1.5	3.1	4.0
https://issues.apache.org/jira/browse/SOLR-1532	1.5	3.1	4.0
https://issues.apache.org/jira/browse/SOLR-1538	1.5	3.1	4.0
https://issues.apache.org/jira/browse/SOLR-1553	1.5	3.1	4.0
https://issues.apache.org/jira/browse/SOLR-1558	1.5	3.1	4.0
https://issues.apache.org/jira/browse/SOLR-1561	1.5	3.1	4.0
https://issues.apache.org/jira/browse/SOLR-1563	1.5	3.1	4.0
https://issues.apache.org/jira/browse/SOLR-1569	1.5	3.1	4.0
https://issues.apache.org/jira/browse/SOLR-1570	1.5	3.1	4.0
https://issues.apache.org/jira/browse/SOLR-1571	1.5	3.1	4.0
https://issues.apache.org/jira/browse/SOLR-1572	1.5	3.1	4.0
https://issues.apache.org/jira/browse/SOLR-1574	1.5	3.1	4.0
https://issues.apache.org/jira/browse/SOLR-1577	1.5	3.1	4.0
https://issues.apache.org/jira/browse/SOLR-1579	1.5	3.1	4.0
https://issues.apache.org/jira/browse/SOLR-1580	1.5	3.1	4.0
https://issues.apache.org/jira/browse/SOLR-1582	1.5	3.1	4.0
https://issues.apache.org/jira/browse/SOLR-1584	1.5	3.1	4.0
https://issues.apache.org/jira/browse/SOLR-1586	1.5	3.1	4.0
https://issues.apache.org/jira/browse/SOLR-1587	1.5	3.1	4.0
https://issues.apache.org/jira/browse/SOLR-1588	1.5	3.1	4.0
https://issues.apache.org/jira/browse/SOLR-1590	1.5	3.1	4.0
https://issues.apache.org/jira/browse/SOLR-1592	1.5	3.1	4.0
https://issues.apache.org/jira/browse/SOLR-1593	1.5	3.1	4.0
https://issues.apache.org/jira/browse/SOLR-1595	1.5	3.1	4.0
https://issues.apache.org/jira/browse/SOLR-1596	1.5	3.1	4.0
https://issues.apache.org/jira/browse/SOLR-1601	1.5	3.1	4.0
https://issues.apache.org/jira/browse/SOLR-1608	1.5	3.1	4.0
https://issues.apache.org/jira/browse/SOLR-1610	1.5	3.1	4.0
https://issues.apache.org/jira/browse/SOLR-1611	1.5	3.1	4.0
https://issues.apache.org/jira/browse/SOLR-1615	1.5	3.1	4.0
https://issues.apache.org/jira/browse/SOLR-1621	1.5	3.1	4.0
https://issues.apache.org/jira/browse/SOLR-1624	1.5	3.1	4.0
https://issues.apache.org/jira/browse/SOLR-1625	1.5	3.1	4.0
https://issues.apache.org/jira/browse/SOLR-1628	1.5	3.1	4.0
https://issues.apache.org/jira/browse/SOLR-1635	1.5	3.1	4.0
https://issues.apache.org/jira/browse/SOLR-1637	1.5	3.1	4.0
https://issues.apache.org/jira/browse/SOLR-1651	1.5	3.1	4.0
https://issues.apache.org/jira/browse/SOLR-1653	1.5	3.1	4.0
https://issues.apache.org/jira/browse/SOLR-1657	3.1	4.0
https://issues.apache.org/jira/browse/SOLR-1660	1.5	3.1	4.0
https://issues.apache.org/jira/browse/SOLR-1661	1.5	3.1	4.0
https://issues.apache.org/jira/browse/SOLR-1662	1.5	3.1	4.0
https://issues.apache.org/jira/browse/SOLR-1667	1.5	3.1	4.0
https://issues.apache.org/jira/browse/SOLR-1674	1.5	3.1	4.0
https://issues.apache.org/jira/browse/SOLR-1677	3.1	4.0
https://issues.apache.org/jira/browse/SOLR-1679	1.5	3.1	4.0
https://issues.apache.org/jira/browse/SOLR-1695	1.5	3.1	4.0
https://issues.apache.org/jira/browse/SOLR-1696	1.5	3.1	4.0
https://issues.apache.org/jira/browse/SOLR-1697	1.5	3.1	4.0
https://issues.apache.org/jira/browse/SOLR-1704	1.5	3.1	4.0
https://issues.apache.org/jira/browse/SOLR-1706	3.1	4.0
https://issues.apache.org/jira/browse/SOLR-1711	1.5	3.1	4.0
https://issues.apache.org/jira/browse/SOLR-1722	1.5	3.1	4.0
https://issues.apache.org/jira/browse/SOLR-1727	1.5	3.1	4.0
https://issues.apache.org/jira/browse/SOLR-1736	1.5	3.1	4.0
https://issues.apache.org/jira/browse/SOLR-1740	3.1	4.0
https://issues.apache.org/jira/browse/SOLR-1744	1.5	3.1	4.0
https://issues.apache.org/jira/browse/SOLR-1745	1.5	3.1	4.0
https://issues.apache.org/jira/browse/SOLR-1746	1.5	3.1	4.0
https://issues.apache.org/jira/browse/SOLR-1747	1.5	3.1	4.0
https://issues.apache.org/jira/browse/SOLR-1748	1.5	3.1	4.0
https://issues.apache.org/jira/browse/SOLR-1750	1.5	3.1	4.0
https://issues.apache.org/jira/browse/SOLR-1753	1.5	3.1	4.0
https://issues.apache.org/jira/browse/SOLR-1769	3.1	4.0
https://issues.apache.org/jira/browse/SOLR-1771	1.5	3.1	4.0
https://issues.apache.org/jira/browse/SOLR-1776	1.5	3.1	4.0
https://issues.apache.org/jira/browse/SOLR-1777	1.5	3.1	4.0
https://issues.apache.org/jira/browse/SOLR-1792	1.5	3.1	4.0
https://issues.apache.org/jira/browse/SOLR-1797	1.5	3.1	4.0
https://issues.apache.org/jira/browse/SOLR-1798	1.5	3.1	4.0
https://issues.apache.org/jira/browse/SOLR-1815	1.5	3.1	4.0
https://issues.apache.org/jira/browse/SOLR-1821	1.5	3.1	4.0
https://issues.apache.org/jira/browse/SOLR-1823	1.5	3.1	4.0
https://issues.apache.org/jira/browse/SOLR-1824	4.0
https://issues.apache.org/jira/browse/SOLR-1843	4.0
https://issues.apache.org/jira/browse/SOLR-1845	3.1	4.0
https://issues.apache.org/jira/browse/SOLR-1846	4.0
https://issues.apache.org/jira/browse/SOLR-1850	3.1	4.0
https://issues.apache.org/jira/browse/SOLR-1851	4.0
https://issues.apache.org/jira/browse/SOLR-1857	3.1	4.0
https://issues.apache.org/jira/browse/SOLR-1865	3.1	4.0
https://issues.apache.org/jira/browse/SOLR-1874	3.1	4.0
https://issues.apache.org/jira/browse/SOLR-1875	4.0
https://issues.apache.org/jira/browse/SOLR-1876	3.1	4.0
https://issues.apache.org/jira/browse/SOLR-1891	3.1	4.0
https://issues.apache.org/jira/browse/SOLR-1902	4.0
https://issues.apache.org/jira/browse/SOLR-1904	4.0
https://issues.apache.org/jira/browse/SOLR-1908	4.0
https://issues.apache.org/jira/browse/SOLR-1923	3.1	4.0
https://issues.apache.org/jira/browse/SOLR-1928	4.0
https://issues.apache.org/jira/browse/SOLR-343	1.5	3.1	4.0
https://issues.apache.org/jira/browse/SOLR-397	4.0
https://issues.apache.org/jira/browse/SOLR-571	4.0
https://issues.apache.org/jira/browse/SOLR-785	1.5	3.1	4.0
https://issues.apache.org/jira/browse/SOLR-945	4.0

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


Re: Solr version housekeeping in Jira/Wiki (1.5, 1.6, 3.x, 4.x, etc...)

Posted by Chris Hostetter <ho...@fucit.org>.
FYI: I'm going to start working on this today, but i don't expect i'll 
finish it all in one go, so i'll reply to this message with incremental 
updates as i finish things and use the thread as an audit log.

: Date: Tue, 25 May 2010 11:34:25 -0700 (PDT)
: From: Chris Hostetter <ho...@fucit.org>
: Reply-To: dev@lucene.apache.org
: To: Lucene Dev <de...@lucene.apache.org>
: Subject: Solr version housekeeping in Jira/Wiki (1.5, 1.6, 3.x, 4.x, etc...)
: 
: 
: A while back, after the trunk merge (but before the 3x branch fork) yonik and
: i spear-headed a healthy depate on the list about whether the next version of
: Solr should have a lock-step version number with Lucene ... while i've
: generally come arround to yonik's way of thinking, that's *not* what this
: thread is about (i say that up front in the hopes of preventing this thread
: from devolving into a continued debate about internal vs marketing version
: numbers)
: 
: Independent of the questions of what branch the next version of SOlr should be
: released on, or what version number "label" it should be called, is the issue
: of keeping straight what bug fixes and features have been added to what
: branches.  Several issues in Jira were marked as "Fixed" in 1.5, prior to the
: trunk merge but with the ambiguity about how the versioning was going to
: evlove, were never bulk updated to indicate that they were actaully going be
: fixed in 3.1 (or 4.0).  Now that we may (or may not) ever have a 1.5 release,
: it can be hard to look at a Jira issue and make sense of where the chnages
: were actually commited.  This has been componded by some committers (i take
: responsibility for being the majority of the problem) continuing to mark
: issues they commit as being fixed in "1.5" even though they commited to the
: "trunk" (after the lucene/solr trunk merge)
: 
: Likewise for the way we annotate information in the Solr wiki.  Several bits
: of documentation are annoated as being in 1.5, but nothing is marked as 3.1 or
: 4.1
: 
: What i'd like to propose is that we focus on making sure the "Fix Version" in
: Jira and the annotations on the wiki correctly reflect the "next" version of
: the *branches* where changes have been commited. Even if (in the unlikely
: event) the final version numbers that we release are ultimatley differnet, we
: can at least be reasonably confident that a simple batch replace will work.
: 
: In concrete terms, these are the steps i'm planning to take in a few days
: unless someone objects, or suggests a simpler path...
: 
: 1) create a new Jira version for Solr called "next" as a way to track
: unresolved issues that people generally feel should be fixed in the "next"
: feature release.
: 
: 2) bulk change any Solr issue currently UNRESOLVED with a "Fix Version" or
: 1.5, 1.6, 3.1, or 4.0 so that it's new Fix Version is "next"
: 
: 3) Compute three diffs, one for each of each of these three CHANGES.txt
: files...
: 
: http://svn.apache.org/viewvc/lucene/solr/branches/branch-1.5-dev/CHANGES.txt
: http://svn.apache.org/viewvc/lucene/dev/branches/branch_3x/solr/CHANGES.txt
: http://svn.apache.org/viewvc/lucene/dev/trunk/solr/CHANGES.txt
: 	...against the official 1.4 CHANGES.txt...
: http://svn.apache.org/viewvc/lucene/solr/tags/release-1.4.0/CHANGES.txt
: 
: 4) merge the diffs from step#3 into a 4 column report, listing every issue
: mentioned in any of those three CHANGES.txt files and which "branches" it has
: been commited to.
: 
: 5) using the report for step#4, manually update every individual issue so that
: the Fix Version accurately the list of *possible* versions that issue will be
: fixed in, if there is a release off of those respective branches (ie: some
: subset of (1.5, 3.1, 4.0))
: 
: 6) delete "1.6" as a Solr version in Jira.
: 
: 7) Update the Solr1.5 wiki page to link to the 1.5 branch in SVN, and add a
: note that such a release may never actually happen...
: http://wiki.apache.org/solr/Solr1.5
: 
: 8) Create new wiki pages for Solr3.1 and Solr4.0, model them after the Solr1.5
: page with pointers to what branch of SVN development is taking place on and
: where to track issues fixed on those branches.  (we can also add verbage here
: about the merged lucene/solr dev model, and why the 3x branch was created, but
: we can worry about that later)
: 
: 9) Audit every link to the Solr1.5 page, and add links to the new Solr3.1 and
: Solr4.0 pages as needed...
: http://wiki.apache.org/solr/Solr1.5?action=fullsearch&context=180&value=linkto%3A%22Solr1.5%22
: 
: 
: ...I'm not particularly looking forward to step #5, but it's the only safe way
: i can thin of to make everything is correct.  I'm open to other suggestions.
: 
: 
: -Hoss
: 
: 
: ---------------------------------------------------------------------
: To unsubscribe, e-mail: dev-unsubscribe@lucene.apache.org
: For additional commands, e-mail: dev-help@lucene.apache.org
: 



-Hoss


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


Re: Solr version housekeeping in Jira/Wiki (1.5, 1.6, 3.x, 4.x, etc...)

Posted by Chris Hostetter <ho...@fucit.org>.
: 5) using the report for step#4, manually update every individual issue so that
: the Fix Version accurately the list of *possible* versions that issue will be
: fixed in, if there is a release off of those respective branches (ie: some
: subset of (1.5, 3.1, 4.0))

Step #5 is done ... it was only about 80% as mind numbingly tedious as i 
expected it to be.

On to the home strech...


-Hoss


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