You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@jackrabbit.apache.org by re...@apache.org on 2018/07/25 11:06:47 UTC
svn commit: r1836618 - in /jackrabbit/site/live/jcr: creating-releases.html
index.html
Author: reschke
Date: Wed Jul 25 11:06:47 2018
New Revision: 1836618
URL: http://svn.apache.org/viewvc?rev=1836618&view=rev
Log:
@trivial: Site checkin for project Apache Jackrabbit Site-1.0-SNAPSHOT
Modified:
jackrabbit/site/live/jcr/creating-releases.html
jackrabbit/site/live/jcr/index.html
Modified: jackrabbit/site/live/jcr/creating-releases.html
URL: http://svn.apache.org/viewvc/jackrabbit/site/live/jcr/creating-releases.html?rev=1836618&r1=1836617&r2=1836618&view=diff
==============================================================================
--- jackrabbit/site/live/jcr/creating-releases.html (original)
+++ jackrabbit/site/live/jcr/creating-releases.html Wed Jul 25 11:06:47 2018
@@ -1,13 +1,13 @@
<!DOCTYPE html>
<!--
- | Generated by Apache Maven Doxia at 2018-06-22
+ | Generated by Apache Maven Doxia at 2018-07-25
| Rendered using Apache Maven Fluido Skin 1.3.1
-->
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
- <meta name="Date-Revision-yyyymmdd" content="20180622" />
+ <meta name="Date-Revision-yyyymmdd" content="20180725" />
<meta http-equiv="Content-Language" content="en" />
<title>Apache Jackrabbit - Creating Releases</title>
<link rel="stylesheet" href="./css/apache-maven-fluido-1.3.1.min.css" />
@@ -189,7 +189,7 @@
<ul class="breadcrumb">
- <li id="publishDate">Last Published: 2018-06-22
+ <li id="publishDate">Last Published: 2018-07-25
</li>
@@ -495,7 +495,7 @@
</ul></li>
<li>
-<p>If this is a stable branch, review changes to export versions which should be avoided (see <a class="externalLink" href="https://issues.apache.org/jira/browse/OAK-6346">OAK-6346</a> for context). Example: review the output of the command below for any changes of <tt>package-info.java</tt>.</p>
+<p>If this is a stable branch, review changes to export versions which should be avoided (see <a class="externalLink" href="https://issues.apache.org/jira/browse/OAK-6346">OAK-6346</a> for context). If there are indeed changes, see <a href="#Appendix_E:_Version_Changes">Appendix E</a>. Example: review the output of the command below for any changes of <tt>package-info.java</tt>.</p>
<div class="source">
<pre># Oak 1.8 as of June 2018
@@ -724,6 +724,26 @@ mvn release:update-versions -DautoVersio
</pre></div>
<p>Open a ticket so that once the first release for the branch is made, the <tt>comparisonVersion</tt> for the <tt>bundle:baseline</tt> check is updated both in the branch and on trunk; example: <a class="externalLink" href="https://issues.apache.org/jira/browse/JCR-4218">JCR-4218</a>.</p>
<p>Create release notes to include all of the changes accumulated - for 2.16.0 this means including all changes labeled with <tt>fixVersion</tt> set to <tt>2.16</tt>. Note that any change labeled with <tt>fixVersion</tt> set to any 2.15.* release should have <tt>fixVersion: 2.16</tt> as well, unless the change is irrelevant for the release notes.</p></div>
+<div class="section">
+<h2>Appendix E: Version Changes<a name="Appendix_E:_Version_Changes"></a></h2>
+<p><b>HERE BE DRAGONS</b></p>
+<p>In general, changes in stable branches should not change export versions, in order to create version conflicts with the ongoing development on the unstable branch. So avoid, avoid, avoid!</p>
+<p>If the version change really is required, then it is mandatory to check that the new API is identical with the API in other release branches with the same version number.</p>
+<p>To check, for example for a version change in Oak 1.6.13-SNAPSHOT:</p>
+
+<ol style="list-style-type: decimal">
+
+<li>
+<p>Checkout Oak 1.8.</p></li>
+
+<li>
+<p>Edit the parent pom to use a comparisonVersion of “1.6.3-SNAPSHOT”. Release branches normally use the default, so the property needs to be added to the maven bundle plugin configuration.</p></li>
+
+<li>
+<p>Build and watch for baseline plugin errors.</p></li>
+</ol>
+<p>…then repeat the above steps with subsequent branches and trunk.</p>
+<p>Also, check with the “dev” mailing list to confirm that this change is ok.</p></div>
</div>
</div>
</div>
Modified: jackrabbit/site/live/jcr/index.html
URL: http://svn.apache.org/viewvc/jackrabbit/site/live/jcr/index.html?rev=1836618&r1=1836617&r2=1836618&view=diff
==============================================================================
--- jackrabbit/site/live/jcr/index.html (original)
+++ jackrabbit/site/live/jcr/index.html Wed Jul 25 11:06:47 2018
@@ -1,13 +1,13 @@
<!DOCTYPE html>
<!--
- | Generated by Apache Maven Doxia at 2018-07-23
+ | Generated by Apache Maven Doxia at 2018-07-25
| Rendered using Apache Maven Fluido Skin 1.3.1
-->
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
- <meta name="Date-Revision-yyyymmdd" content="20180723" />
+ <meta name="Date-Revision-yyyymmdd" content="20180725" />
<meta http-equiv="Content-Language" content="en" />
<title>Apache Jackrabbit - Welcome to Apache Jackrabbit</title>
<link rel="stylesheet" href="./css/apache-maven-fluido-1.3.1.min.css" />
@@ -189,7 +189,7 @@
<ul class="breadcrumb">
- <li id="publishDate">Last Published: 2018-07-23
+ <li id="publishDate">Last Published: 2018-07-25
</li>