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 2015/07/28 14:55:33 UTC
[36/50] zest-java git commit: ZEST-100 Release howto refinements
ZEST-100 Release howto refinements
Project: http://git-wip-us.apache.org/repos/asf/zest-java/repo
Commit: http://git-wip-us.apache.org/repos/asf/zest-java/commit/19a9ab2a
Tree: http://git-wip-us.apache.org/repos/asf/zest-java/tree/19a9ab2a
Diff: http://git-wip-us.apache.org/repos/asf/zest-java/diff/19a9ab2a
Branch: refs/heads/master
Commit: 19a9ab2a77e9b2e24a6f3d4cf9a2994c2d2b652e
Parents: 2204d78
Author: Paul Merlin <pa...@apache.org>
Authored: Sat Jul 25 01:12:07 2015 +0200
Committer: Paul Merlin <pa...@apache.org>
Committed: Sat Jul 25 01:12:07 2015 +0200
----------------------------------------------------------------------
build.gradle | 4 +-
manual/build.gradle | 8 +-
.../src/docs/tutorials/howto-build-system.txt | 15 ++
.../docs/tutorials/howto-releasing-apache.txt | 218 ++++++++++++-------
4 files changed, 166 insertions(+), 79 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/zest-java/blob/19a9ab2a/build.gradle
----------------------------------------------------------------------
diff --git a/build.gradle b/build.gradle
index 7da47d6..301c25a 100644
--- a/build.gradle
+++ b/build.gradle
@@ -562,11 +562,11 @@ task archiveJavadocs(type: Copy ) {
if( rootProject.version == '0' || rootProject.version.contains( "SNAPSHOT" ) )
{
- into( "$rootProject.projectDir/../zest-svn/site/content/java/develop/javadocs/" )
+ into( "$rootProject.projectDir/../zest-web/site/content/java/develop/javadocs/" )
}
else
{
- into( "$rootProject.projectDir/../zest-svn/site/content/java/$version/javadocs/" )
+ into( "$rootProject.projectDir/../zest-web/site/content/java/$version/javadocs/" )
}
from( 'build/docs/javadoc/' )
}
http://git-wip-us.apache.org/repos/asf/zest-java/blob/19a9ab2a/manual/build.gradle
----------------------------------------------------------------------
diff --git a/manual/build.gradle b/manual/build.gradle
index 403dd27..c754880 100644
--- a/manual/build.gradle
+++ b/manual/build.gradle
@@ -54,11 +54,11 @@ task archiveWebsite( type: Copy ) {
dependsOn website
if( rootProject.version == '0' || rootProject.version.contains( "SNAPSHOT" ) )
{
- into( "$rootProject.projectDir/../zest-svn/site/content/java/develop" )
+ into( "$rootProject.projectDir/../zest-web/site/content/java/develop" )
}
else
{
- into( "$rootProject.projectDir/../zest-svn/site/content/java/$version" )
+ into( "$rootProject.projectDir/../zest-web/site/content/java/$version" )
}
from( 'build/docs/website/' )
}
@@ -67,8 +67,8 @@ task copyWebsite( type: Copy ) {
dependsOn archiveWebsite
if( rootProject.version != '0' && !rootProject.version.contains( "SNAPSHOT" ) )
{
- from( "$rootProject.projectDir/../zest-svn/site/content/java/$version/" )
- into( "$rootProject.projectDir/../zest-svn/site/content/java/latest/" )
+ from( "$rootProject.projectDir/../zest-web/site/content/java/$version/" )
+ into( "$rootProject.projectDir/../zest-web/site/content/java/latest/" )
}
}
http://git-wip-us.apache.org/repos/asf/zest-java/blob/19a9ab2a/manual/src/docs/tutorials/howto-build-system.txt
----------------------------------------------------------------------
diff --git a/manual/src/docs/tutorials/howto-build-system.txt b/manual/src/docs/tutorials/howto-build-system.txt
index aa72a98..ab2d3fa 100644
--- a/manual/src/docs/tutorials/howto-build-system.txt
+++ b/manual/src/docs/tutorials/howto-build-system.txt
@@ -171,6 +171,21 @@ They can be run with the following Gradle command:
Results will then be available in the test reports.
+== Documentation generation ==
+
+The build generates a documentation minisite:
+
+[source,bash]
+-----------
+./gradlew -p manual website
+-----------
+
+Output is in `~/manual/build/docs/website`.
+
+You'll need Asciidoc and docbook-xsl installed.
+
+
+
== Build for releases ==
IMPORTANT: Remember that if a +version+ property is not defined, the build system will refuse to make a release and upload.
http://git-wip-us.apache.org/repos/asf/zest-java/blob/19a9ab2a/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 e56d2f4..d8e459b 100644
--- a/manual/src/docs/tutorials/howto-releasing-apache.txt
+++ b/manual/src/docs/tutorials/howto-releasing-apache.txt
@@ -20,19 +20,17 @@
[[releasing-apache,Releasing Zest]]
= Releasing Zest™
-This tutorial is intended for Apache Zest™ commiters who want to release a new version of Apache Zest™ (Java Edition) at The Apache Software Foundation.
-It describes the tools and processes of a typical release.
-
-It is intended to be a recommendation of best practices for the Apache Zest™ project.
-The instructions provided here are consistent with, but not a replacement for the https://www.apache.org/dev/release.html[ASF Release Guidelines].
-
[WARNING]
====
You need a unix-like environment to actually perform the release process.
This tutorial is known to work on Linux and Mac.
====
-Before going further you obviously should have read the <<build-system, Build System>> tutorial and already built Zest™ from source, signing included.
+This tutorial is intended for Apache Zest™ commiters who want to release a new version of Apache Zest™ (Java Edition) at The Apache Software Foundation.
+It describes the tools and processes of a typical release.
+
+It is intended to be a recommendation of best practices for the Apache Zest™ project.
+The instructions provided here are consistent with, but not a replacement for the https://www.apache.org/dev/release.html[ASF Release Guidelines].
@@ -54,9 +52,13 @@ Clone/checkout all needed repositories, next to each other:
mkdir zest-repos
cd zest-repos
git clone https://git-wip-us.apache.org/repos/asf/zest-java.git zest-java
-svn checkout https://svn.apache.org/repos/asf/zest/ zest-svn
-svn checkout https://dist.apache.org/repos/dist/dev/zest/ zest-dist-dev
-svn checkout https://dist.apache.org/repos/dist/release/zest/ zest-dist-release
+svn checkout https://svn.apache.org/repos/asf/zest/ zest-web
+svn checkout --depth empty https://dist.apache.org/repos/dist/ zest-dist
+cd zest-dist
+svn update --set-depth immediates dev
+svn update --set-depth immediates release
+svn update --set-depth infinity dev/zest
+svn update --set-depth infinity release/zest
----
You should then get the following directory tree:
@@ -66,15 +68,34 @@ You should then get the following directory tree:
.
└── zest-repos
├── zest-java # Apache Zest™ (Java Edition) source
- ├── zest-svn # https://zest.apache.org/ website
- ├── zest-dist-dev # Releases candidate distributions
- └── zest-dist-release # Releases distributions
+ ├── zest-web # https://zest.apache.org/ website
+ └── zest-dist
+ ├── dev
+ | └── zest # Releases candidate distributions
+ └── release
+ └── zest # Releases distributions
----
+[TIP]
+====
+From now on, all command line snippets start from the `zest-repos` directory.
+====
+
+
=== Build Apache Zest™ (Java Edition)
-Ensure you can test, build and sign Zest, including artifact signing, see the <<build-system, Build System>> tutorial.
+Ensure you can test, build Apache Zest™ (Java Edition), including the documentation minisite generation using Asciidoc and artifact signing.
+
+Here is what should pass before going further:
+
+[source,shell]
+----
+cd zest-java
+./gradlew -Dversion="<RELEASE-VERSION>" website signArchives
+----
+
+See the <<build-system, Build System>> tutorial for details.
=== Install Jekyll
@@ -105,31 +126,28 @@ See the https://git-scm.com/book/tr/v2/Git-Tools-Signing-Your-Work[Git Tools - S
See the Apache https://www.apache.org/dev/publishing-maven-artifacts.html[Publishing Maven Artifacts] guide and the Apache Zest™ (Java Edition) <<build-system,Build System>> tutorial.
-=== Update the `KEYS` file if needed.
+=== Update the `KEYS` files if needed.
-The reference `KEYS` file can be found at the `zest-java` repository's root.
+The reference `KEYS` file can be found at the `zest-java` repository's root, that is `zest-java/KEYS`.
+Ensure that it contains your public key.
-Diff the ones present in the `dev` and `release` distribution areas:
+Next, diff it against the ones present in the `dev` and `release` distribution areas:
[source,shell]
----
-diff zest-java/KEYS zest-dist-dev/KEYS
-diff zest-java/KEYS zest-dist-release/KEYS
+diff zest-java/KEYS zest-dist/dev/zest/KEYS
+diff zest-java/KEYS zest-dist/release/zest/KEYS
----
And update them if needed:
[source,shell]
----
-cp zest-java/KEYS zest-dist-dev/KEYS
-cp zest-java/KEYS zest-dist-release/KEYS
-cd zest-dist-dev
-svn add KEYS
-svn commit -m "zest: updating KEYS in dist/dev/zest"
-cd ..
-cd zest-dist-release
-svn add KEYS
-svn commit -m "zest: updating KEYS in dist/release/zest"
+cp zest-java/KEYS zest-dist/dev/zest/KEYS
+cp zest-java/KEYS zest-dist/release/zest/KEYS
+cd zest-dist/dev/zest
+svn add dev/zest/KEYS release/zest/KEYS
+svn commit -m "zest: updating Zest KEYS"
----
@@ -168,21 +186,21 @@ Convert to Asciidoc:
[source,shell]
----
-cat apache-zest-java-<RELEASE-VERSION>-release-notes.txt | \
+cat "apache-zest-java-<RELEASE-VERSION>-release-notes.txt" | \
sed -e "s/* \[ZEST-\([0-9]\)*\]/- https:\/\/issues.apache.org\/jira\/browse\/ZEST-\1[ZEST-\1]/" | \
- sed -e "s/^\*\*/===/" > apache-zest-java-<RELEASE-VERSION>-release-notes.adoc
+ sed -e "s/^\*\*/===/" > "apache-zest-java-<RELEASE-VERSION>-release-notes.adoc"
----
Convert to Markdown:
[source,shell]
----
-cat apache-zest-java-<RELEASE-VERSION>-release-notes.txt | \
+cat "apache-zest-java-<RELEASE-VERSION>-release-notes.txt" | \
sed -e "s/* \[ZEST-\([0-9]\)*\]/- [ZEST-\1](https:\/\/issues.apache.org\/jira\/browse\/ZEST-\1)/" | \
- sed -e "s/^\*\*/###/" > apache-zest-java-<RELEASE-VERSION>-release-notes.md
+ sed -e "s/^\*\*/###/" > "apache-zest-java-<RELEASE-VERSION>-release-notes.md"
----
-You should then have the two following files:
+You should then have the following files:
[source,shell]
----
@@ -201,10 +219,11 @@ We use `<RELEASE-VERSION>-RC#` where `RELEASE-VERSION` is the target release ver
[source,shell]
----
-git flow release start <RELEASE-VERSION>-RC#
+cd zest-java
+git flow release start "<RELEASE-VERSION>-RC#"
----
-This will eventually generates a `<RELEASE-VERSION>-RC#` tag that we will rename to `<RELEASE-VERSION>` if the vote passes, see below.
+This will eventually generates a `<RELEASE-VERSION>-RC#` tag that we will amend with a `<RELEASE-VERSION>` signed tag if the vote passes, see below.
=== Audit artifacts and distributions
@@ -213,8 +232,9 @@ Make a complete build, deploying maven artifacts locally:
[source,shell]
----
-./gradlew -Dversion=<RELEASE-VERSION> -PuploadRepository="file://$(pwd)/build/repositories/zest-java" \
- clean buildAll checkDists uploadArchives
+cd zest-java
+./gradlew -Dversion="<RELEASE-VERSION>" -PuploadRepository="file://$(pwd)/build/repositories/zest-java" \
+ clean assemble checkDists uploadArchives
----
Review maven artifacts in `build/repositories/zest-java`.
@@ -251,7 +271,8 @@ Once you are satisfied with the produced artifacts, close the release candidate
[source,shell]
----
-git flow release finish <RELEASE-VERSION>-RC#
+cd zest-java
+git flow release finish "<RELEASE-VERSION>-RC#"
----
@@ -261,7 +282,8 @@ To build the release candidate bits, we need to checkout the release candidate t
[source,shell]
----
-git checkout <RELEASE-VERSION>-RC#
+cd zest-java
+git checkout "<RELEASE-VERSION>-RC#"
----
@@ -269,7 +291,8 @@ git checkout <RELEASE-VERSION>-RC#
[source,shell]
----
-./gradlew -Dversion=<RELEASE-VERSION> clean check buildAll checkDists
+cd zest-java
+./gradlew -Dversion="<RELEASE-VERSION>" clean assemble
----
@@ -279,7 +302,8 @@ Stage artifacts to https://repository.apache.org/[repository.apache.org] :
[source,shell]
----
-./gradlew -Dversion=<RELEASE-VERSION> uploadArchives
+cd zest-java
+./gradlew -Dversion="<RELEASE-VERSION>" uploadArchives
----
Close the staging Nexus repository by following the https://www.apache.org/dev/publishing-maven-artifacts.html#close-stage[Closing the staged repository] guide.
@@ -287,13 +311,39 @@ Close the staging Nexus repository by following the https://www.apache.org/dev/p
=== Upload RC distributions
-Upload source and binary distributions, checksums and signatures to https://dist.apache.org/repos/dist/dev/zest/[dist.apache.org/repos/dist/dev/zest]:
+Source and binary distributions, checksums and signatures must be uploaded to https://dist.apache.org/repos/dist/dev/zest/[dist.apache.org/repos/dist/dev/zest].
+This build created these in the `buid/distributions` directory, named `apache-zest-java-<RELEASE-VERSION>-[src|bin]*.*`.
+As this release still is a simple candidate, we'll rename them before upload to advertise this in their names.
[source,shell]
----
-cp zest-java/build/distributions/apache-zest-java-<RELEASE-VERSION>-src* zest-dist-dev/
-cp zest-java/build/distributions/apache-zest-java-<RELEASE-VERSION>-bin* zest-dist-dev/
-cd zest-dist-dev
+# Source ZIP
+cp "zest-java/build/distributions/apache-zest-java-<RELEASE-VERSION>-src.zip" "zest-dist/dev/zest/apache-zest-java-<RELEASE-VERSION>-RC#-src.zip"
+cp "zest-java/build/distributions/apache-zest-java-<RELEASE-VERSION>-src.zip.MD5" "zest-dist/dev/zest/apache-zest-java-<RELEASE-VERSION>-RC#-src.zip.MD5"
+cp "zest-java/build/distributions/apache-zest-java-<RELEASE-VERSION>-src.zip.SHA-512" "zest-dist/dev/zest/apache-zest-java-<RELEASE-VERSION>-RC#-src.zip.SHA-512"
+cp "zest-java/build/distributions/apache-zest-java-<RELEASE-VERSION>-src.zip.asc" "zest-dist/dev/zest/apache-zest-java-<RELEASE-VERSION>-RC#-src.zip.asc"
+# Source TAR.GZ
+cp "zest-java/build/distributions/apache-zest-java-<RELEASE-VERSION>-src.tgz" "zest-dist/dev/zest/apache-zest-java-<RELEASE-VERSION>-RC#-src.tgz"
+cp "zest-java/build/distributions/apache-zest-java-<RELEASE-VERSION>-src.tgz.MD5" "zest-dist/dev/zest/apache-zest-java-<RELEASE-VERSION>-RC#-src.tgz.MD5"
+cp "zest-java/build/distributions/apache-zest-java-<RELEASE-VERSION>-src.tgz.SHA-512" "zest-dist/dev/zest/apache-zest-java-<RELEASE-VERSION>-RC#-src.tgz.SHA-512"
+cp "zest-java/build/distributions/apache-zest-java-<RELEASE-VERSION>-src.tgz.asc" "zest-dist/dev/zest/apache-zest-java-<RELEASE-VERSION>-RC#-src.tgz.asc"
+# Binary ZIP
+cp "zest-java/build/distributions/apache-zest-java-<RELEASE-VERSION>-bin.zip" "zest-dist/dev/zest/apache-zest-java-<RELEASE-VERSION>-RC#-bin.zip"
+cp "zest-java/build/distributions/apache-zest-java-<RELEASE-VERSION>-bin.zip.MD5" "zest-dist/dev/zest/apache-zest-java-<RELEASE-VERSION>-RC#-bin.zip.MD5"
+cp "zest-java/build/distributions/apache-zest-java-<RELEASE-VERSION>-bin.zip.SHA-512" "zest-dist/dev/zest/apache-zest-java-<RELEASE-VERSION>-RC#-bin.zip.SHA-512"
+cp "zest-java/build/distributions/apache-zest-java-<RELEASE-VERSION>-bin.zip.asc" "zest-dist/dev/zest/apache-zest-java-<RELEASE-VERSION>-RC#-bin.zip.asc"
+# Binary TAR.GZ
+cp "zest-java/build/distributions/apache-zest-java-<RELEASE-VERSION>-bin.tgz" "zest-dist/dev/zest/apache-zest-java-<RELEASE-VERSION>-RC#-bin.tgz"
+cp "zest-java/build/distributions/apache-zest-java-<RELEASE-VERSION>-bin.tgz.MD5" "zest-dist/dev/zest/apache-zest-java-<RELEASE-VERSION>-RC#-bin.tgz.MD5"
+cp "zest-java/build/distributions/apache-zest-java-<RELEASE-VERSION>-bin.tgz.SHA-512" "zest-dist/dev/zest/apache-zest-java-<RELEASE-VERSION>-RC#-bin.tgz.SHA-512"
+cp "zest-java/build/distributions/apache-zest-java-<RELEASE-VERSION>-bin.tgz.asc" "zest-dist/dev/zest/apache-zest-java-<RELEASE-VERSION>-RC#-bin.tgz.asc"
+----
+
+And then upload them:
+
+[source,shell]
+----
+cd zest-dist/dev/zest
svn add * --force
svn commit -m "zest: upload <RELEASE-VERSION> to dist/dev/zest"
----
@@ -359,7 +409,7 @@ Create and sign the release git tag from the unsigned release candidate tag:
[source,shell]
----
cd zest-java
-git tag -s <RELEASE-VERSION> <RELEASE-VERSION>-RC#
+git tag -s "<RELEASE-VERSION>" "<RELEASE-VERSION>-RC#"
----
Push all git changes:
@@ -379,19 +429,39 @@ git push origin --tags
Promote the staged Nexus repository so it gets synched to Maven Central by following the https://www.apache.org/dev/publishing-maven-artifacts.html#promote[Promoting a repo] guide.
-Move the release distributions, checksums and signatures from https://dist.apache.org/repos/dist/dev/zest/[dist.apache.org/repos/dist/dev/zest] to https://dist.apache.org/repos/dist/release/zest/[dist.apache.org/repos/dist/release/zest]
+Move the release distributions, checksums and signatures from https://dist.apache.org/repos/dist/dev/zest/[zest-dist/dev/zest] to https://dist.apache.org/repos/dist/release/zest/[zest-dist/release/zest]:
[source,shell]
----
-mv zest-dist-dev/apache-zest-java-<RELEASE-VERSION>-src* zest-dist-release/
-mv zest-dist-dev/apache-zest-java-<RELEASE-VERSION>-bin* zest-dist-release/
-cd zest-dist-dev
-svn add * --force
-svn commit -m "zest: removing <RELEASE-VERSION> from dist/dev/zest as the VOTE passed"
-cd ..
-cd zest-dist-release
-svn add * --force
-svn commit -m "zest: upload <RELEASE-VERSION> to dist/release/zest""
+cd zest-dist
+# Source ZIP
+svn move "dev/zest/apache-zest-java-<RELEASE-VERSION>-RC#-src.zip" "release/zest/apache-zest-java-<RELEASE-VERSION>-src.zip"
+svn move "dev/zest/apache-zest-java-<RELEASE-VERSION>-RC#-src.zip.MD5" "release/zest/apache-zest-java-<RELEASE-VERSION>-src.zip.MD5"
+svn move "dev/zest/apache-zest-java-<RELEASE-VERSION>-RC#-src.zip.SHA-512" "release/zest/apache-zest-java-<RELEASE-VERSION>-src.zip.SHA-512"
+svn move "dev/zest/apache-zest-java-<RELEASE-VERSION>-RC#-src.zip.asc" "release/zest/apache-zest-java-<RELEASE-VERSION>-src.zip.asc"
+# Source TAR.GZ
+svn move "dev/zest/apache-zest-java-<RELEASE-VERSION>-RC#-src.tgz" "release/zest/apache-zest-java-<RELEASE-VERSION>-src.tgz"
+svn move "dev/zest/apache-zest-java-<RELEASE-VERSION>-RC#-src.tgz.MD5" "release/zest/apache-zest-java-<RELEASE-VERSION>-src.tgz.MD5"
+svn move "dev/zest/apache-zest-java-<RELEASE-VERSION>-RC#-src.tgz.SHA-512" "release/zest/apache-zest-java-<RELEASE-VERSION>-src.tgz.SHA-512"
+svn move "dev/zest/apache-zest-java-<RELEASE-VERSION>-RC#-src.tgz.asc" "release/zest/apache-zest-java-<RELEASE-VERSION>-src.tgz.asc"
+# Binary ZIP
+svn move "dev/zest/apache-zest-java-<RELEASE-VERSION>-RC#-bin.zip" "release/zest/apache-zest-java-<RELEASE-VERSION>-bin.zip"
+svn move "dev/zest/apache-zest-java-<RELEASE-VERSION>-RC#-bin.zip.MD5" "release/zest/apache-zest-java-<RELEASE-VERSION>-bin.zip.MD5"
+svn move "dev/zest/apache-zest-java-<RELEASE-VERSION>-RC#-bin.zip.SHA-512" "release/zest/apache-zest-java-<RELEASE-VERSION>-bin.zip.SHA-512"
+svn move "dev/zest/apache-zest-java-<RELEASE-VERSION>-RC#-bin.zip.asc" "release/zest/apache-zest-java-<RELEASE-VERSION>-bin.zip.asc"
+# Binary TAR.GZ
+svn move "dev/zest/apache-zest-java-<RELEASE-VERSION>-RC#-bin.tgz" "release/zest/apache-zest-java-<RELEASE-VERSION>-bin.tgz"
+svn move "dev/zest/apache-zest-java-<RELEASE-VERSION>-RC#-bin.tgz.MD5" "release/zest/apache-zest-java-<RELEASE-VERSION>-bin.tgz.MD5"
+svn move "dev/zest/apache-zest-java-<RELEASE-VERSION>-RC#-bin.tgz.SHA-512" "release/zest/apache-zest-java-<RELEASE-VERSION>-bin.tgz.SHA-512"
+svn move "dev/zest/apache-zest-java-<RELEASE-VERSION>-RC#-bin.tgz.asc" "release/zest/apache-zest-java-<RELEASE-VERSION>-bin.tgz.asc"
+----
+
+And upload them:
+
+[source,shell]
+----
+cd zest-dist
+svn commit -m "zest: <RELEASE-VERSION>-RC# vote passed, promoted as <RELEASE-VERSION> release"
----
@@ -408,8 +478,8 @@ Coordinate a press release with press@apache.org.
You can reuse the release-notes content from the `txt`/`adoc`/`md` files created earlier.
-This annoucement will be used in a veriety of media like emails, websites etc...
-Start with a text version and once satisfied produce at least a Markdown version for the website, see below.
+This annoucement will be used in a variety of media like emails, websites etc...
+Start with a text version and once satisfied create at least a Markdown version for the website, see below.
=== Update the Zest™ website
@@ -419,25 +489,25 @@ Generate the documentation and javadoc minisite:
[source,shell]
----
cd zest-java
-./gradlew -Dversion=<RELEASE-VERSION> archiveJavadocs manuals
+./gradlew -Dversion="<RELEASE-VERSION>" archiveJavadocs manuals
----
-This will automatically put all files into the `zest-svn` website repository.
+This will automatically put all files into the `zest-web` website repository.
Create a new post on the Zest™ website by creating a new Markdown file:
[source,shell]
----
-cd zest-svn
-touch site/src/_posts/YYYY-MM-DD-apache-zest-java-<RELEASE-VERSION>.md
+cd zest-web
+touch "site/src/_posts/YYYY-MM-DD-apache-zest-java-<RELEASE-VERSION>.md"
open !$
----
You can reuse the Markdown formatted announcement content.
-Add the new released version in `zest-svn/site/content/java/versions.json` below the `latest` entry:
+Add the new released version in `zest-web/site/content/java/versions.json` below the `latest` entry:
-[source,json]
+[source,js]
----
{
"develop": "develop",
@@ -448,10 +518,10 @@ Add the new released version in `zest-svn/site/content/java/versions.json` below
}
----
-Finally, edit `zest-svn/site/src/_data/releases.yml` with the new release data.
+Finally, edit `zest-web/site/src/_data/releases.yml` with the new release data.
Upmost is the latest:
-[source,yaml]
+[source,text]
----
- version: <RELEASE-VERSION>
announcement: YYYY/MM/DD/apache-zest-java-<RELEASE-VERSION>
@@ -459,19 +529,21 @@ Upmost is the latest:
pgpId: FB751943
----
-You can live-preview your changes to the Zest™ website:
+You can run the Zest™ website locally:
[source,shell]
----
-cd zest-svn
+cd zest-web
jekyll serve
----
+Open http://127.0.0.1:4000/[http://127.0.0.1:4000/] to live-preview your changes.
+
Once you are satisfied with the changes, build the production website:
[source,shell]
----
-cd zest-svn
+cd zest-web
jekyll build
----
@@ -526,14 +598,14 @@ git push origin --tags
Drop the Nexus staging repository by following the https://www.apache.org/dev/publishing-maven-artifacts.html#drop[Dropping a repo] guide.
-Drop distributions, checksums and signatures from https://dist.apache.org/repos/dist/dev/zest/[dist.apache.org/repos/dist/dev/zest]
+Drop distributions, checksums and signatures from https://dist.apache.org/repos/dist/dev/zest/[zest-dist/dev/zest]
[source,shell]
----
-cd zest-dist-dev/
-rm "*<RELEASE-VERSION>*.*"
+cd zest-dist/dev/zest/
+rm "*<RELEASE-VERSION>-RC#*.*"
svn add * --force
-svn commit -m "zest: dropping <RELEASE-VERSION> from dist/dev/zest as the vote failed"
+svn commit -m "zest: dropping <RELEASE-VERSION>-RC# from dist/dev/zest as the vote failed"
----