You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@polygene.apache.org by pa...@apache.org on 2017/04/10 16:41:41 UTC
polygene-java git commit: Refine release HOW-TO
Repository: polygene-java
Updated Branches:
refs/heads/develop 965036e0c -> 8e2a2da3e
Refine release HOW-TO
Project: http://git-wip-us.apache.org/repos/asf/polygene-java/repo
Commit: http://git-wip-us.apache.org/repos/asf/polygene-java/commit/8e2a2da3
Tree: http://git-wip-us.apache.org/repos/asf/polygene-java/tree/8e2a2da3
Diff: http://git-wip-us.apache.org/repos/asf/polygene-java/diff/8e2a2da3
Branch: refs/heads/develop
Commit: 8e2a2da3e607a4faa131cb8e4420080521993990
Parents: 965036e
Author: Paul Merlin <pa...@apache.org>
Authored: Mon Apr 10 18:39:57 2017 +0200
Committer: Paul Merlin <pa...@apache.org>
Committed: Mon Apr 10 18:39:57 2017 +0200
----------------------------------------------------------------------
.../docs/tutorials/howto-releasing-apache.txt | 37 +++++++++++++++-----
1 file changed, 28 insertions(+), 9 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/polygene-java/blob/8e2a2da3/manual/src/docs/tutorials/howto-releasing-apache.txt
----------------------------------------------------------------------
diff --git a/manual/src/docs/tutorials/howto-releasing-apache.txt b/manual/src/docs/tutorials/howto-releasing-apache.txt
index 79c90e2..1290d9c 100644
--- a/manual/src/docs/tutorials/howto-releasing-apache.txt
+++ b/manual/src/docs/tutorials/howto-releasing-apache.txt
@@ -53,6 +53,9 @@ mkdir polygene-repos
cd polygene-repos
git clone https://git-wip-us.apache.org/repos/asf/polygene-java.git polygene-java
git clone https://git-wip-us.apache.org/repos/asf/polygene-website.git polygene-website
+cd polygene-website
+git checkout asf-site
+cd ..
svn checkout --depth empty https://dist.apache.org/repos/dist/ polygene-dist
cd polygene-dist
svn update --set-depth immediates dev
@@ -68,7 +71,7 @@ You should then get the following directory tree:
.
\u2514\u2500\u2500 polygene-repos
\u251c\u2500\u2500 polygene-java # Apache Polygene\u2122 (Java Edition) source
- \u251c\u2500\u2500 polygene-web # https://polygene.apache.org/ website
+ \u251c\u2500\u2500 polygene-website # https://polygene.apache.org/ website
\u2514\u2500\u2500 polygene-dist
\u251c\u2500\u2500 dev
| \u2514\u2500\u2500 polygene # Releases candidate distributions
@@ -92,11 +95,15 @@ Here is what should pass before going further:
[source,shell]
----
cd polygene-java
-./gradlew -Dversion="<RELEASE-VERSION>" check website
+./gradlew -Dversion="<RELEASE-VERSION>" checkDistributions
----
See the <<build-system, Build System>> tutorial for details.
+[IMPORTANT]
+====
+Also ensure that the link:https://builds.apache.org/view/P/view/Polygene/job/Polygene(JavaEdition)-develop-java8-checkDists/[`checkDists`] CI build is passing.
+====
=== Install Jekyll
@@ -393,6 +400,8 @@ Convenience artifacts in a maven repository are staged here: https://repository.
Release distributions and convenience artifacts are signed with the following key: https://dist.apache.org/repos/dist/dev/polygene/KEYS
+Some guidance on how to validate distributions and artifacts can be found here: https://polygene.apache.org/java/develop/releasing-apache.html#_verifying_a_release_candidate
+
Please vote on releasing this package as Apache Polygene (Java Edition) <RELEASE-VERSION>.
The vote is open for the next 72 hours and passes if a majority of at least three +1 PMC votes are cast and there must be more positive than negative votes.
@@ -665,23 +674,23 @@ Generate the documentation and javadoc minisite:
[source,shell]
----
cd polygene-java
-./gradlew -Dversion="<RELEASE-VERSION>" publishAsfDocumentation
+./gradlew -Dversion="<RELEASE-VERSION>" copyAsfDocumentation
----
-This will automatically put all files into the `polygene-web` website repository.
+This will automatically put all files into the `polygene-website` website repository.
Create a new post on the Polygene\u2122 website by creating a new Markdown file:
[source,shell]
----
-cd polygene-web
+cd polygene-website
touch "src/_posts/YYYY-MM-DD-apache-polygene-java-<RELEASE-VERSION>.md"
open !$
----
You can reuse the Markdown formatted announcement content.
-Add the new released version in `polygene-web/site/content/java/versions.json` below the `latest` entry:
+Add the new released version in `polygene-website/site/content/java/versions.json` below the `latest` entry:
[source,js]
----
@@ -694,7 +703,7 @@ Add the new released version in `polygene-web/site/content/java/versions.json` b
}
----
-Finally, edit `polygene-web/site/src/_data/releases.yml` with the new release data.
+Finally, edit `polygene-website/site/src/_data/releases.yml` with the new release data.
Upmost is the latest:
[source,text]
@@ -709,7 +718,7 @@ You can run the Polygene\u2122 website locally:
[source,shell]
----
-cd polygene-web
+cd polygene-website
jekyll serve
----
@@ -719,16 +728,26 @@ Once you are satisfied with the changes, build the production website:
[source,shell]
----
-cd polygene-web
+cd polygene-website
jekyll build
----
+Link `/latest` to the latest release:
+
+[source,shell]
+----
+cd polygene-website/content/java
+ln -s <RELEASE_VERSION> latest
+----
+
And publish it:
[source,shell]
----
+cd polygene-website
git add .
git commit -m "update website"
+git push
----