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 2017/11/02 14:40:43 UTC

svn commit: r1814086 - /jackrabbit/site/trunk/src/site/markdown/creating-releases.md

Author: reschke
Date: Thu Nov  2 14:40:43 2017
New Revision: 1814086

URL: http://svn.apache.org/viewvc?rev=1814086&view=rev
Log:
improve release docs wrt markdown generation

Modified:
    jackrabbit/site/trunk/src/site/markdown/creating-releases.md

Modified: jackrabbit/site/trunk/src/site/markdown/creating-releases.md
URL: http://svn.apache.org/viewvc/jackrabbit/site/trunk/src/site/markdown/creating-releases.md?rev=1814086&r1=1814085&r2=1814086&view=diff
==============================================================================
--- jackrabbit/site/trunk/src/site/markdown/creating-releases.md (original)
+++ jackrabbit/site/trunk/src/site/markdown/creating-releases.md Thu Nov  2 14:40:43 2017
@@ -95,7 +95,7 @@ Release management tasks
 
 13. Update the Jackrabbit web site to point to the new release ([SVN](https://svn.apache.org/repos/asf/jackrabbit/site/trunk/)).
     1. index.md
-    2. downloads.md (while doing so please a) remove obsoleted entries, and b) move new entries for Jackrabbit and/or Oak to the top)
+    2. downloads.md (see [below](#Creating_Markdown_for_Downloads_Page)) - while doing so please a) remove obsoleted entries, and b) move new entries for Jackrabbit and/or Oak to the top)
 14. Send the [release announcement](mailto:announce@apache.org,announce@jackrabbit.apache.org,users@jackrabbit.apache.org,dev@jackrabbit.apache.org,oak-dev@jackrabbit.apache.org?subject=%5BANNOUNCE%5D%20Apache%20Jackrabbit%20...%20released) once the web site and download mirrors have been synced. Please note the announce mails needs to be sent from an @apache.org address.
 15. If the release was a Jackrabbit release used in Oak, make sure to also update the dependency in oak-parent/pom.xml (example: [OAK-4743](https://issues.apache.org/jira/browse/OAK-4743) - the current mapping is Jackrabbit 2.15 -> Oak trunk, Jackrabbit 2.14 -> Oak 1.6, Jackrabbit 2.12 -> Oak 1.4 and 1.2, Jackrabbit 2.8 -> Oak 1.0)
 16. If the release was a stable release for which we publish API docs (such as Jackrabbit), consider updating the live site (https://svn.apache.org/repos/asf/jackrabbit/site/live/ - when producing the API docs, use a checkout of the actual release, specify an English locale (-Dlocale=en) and try to pick the right JDK version to minimize changes over the previously checked in docs).
@@ -115,6 +115,32 @@ There have been some problems with certa
 After this is done, you can remove the passwords from the file `~/.m2/settings.xml` if you don't want to keep it there.
 
 
+Creating Markdown for Downloads Page
+------------------------------------
+A [shell script](https://dist.apache.org/repos/dist/dev/jackrabbit/create-download-md.sh) is available for generating the downloads links for the mark down source,
+to be run in a checkout of the [release folder](https://dist.apache.org/repos/dist/release/jackrabbit/).
+Usage:
+
+        $ cd path-of-jackrabbit-releases
+        
+For Jackrabbit:
+
+        $ sh create-download-md.sh version
+        
+such as:                
+
+        $ sh create-download-md.sh 2.14.4
+
+For Oak:
+
+        $ sh create-download-md.sh oak/version
+   
+such as:                
+
+        $ sh create-download-md.sh oak/1.6.6
+
+
+
 Related Links
 -------------
 * http://www.apache.org/dev/release.html