Repository: zest-java Updated Branches: refs/heads/develop 2204d7887 -> 19a9ab2a7
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/develop Commit: 19a9ab2a77e9b2e24a6f3d4cf9a2994c2d2b652e Parents: 2204d78 Author: Paul Merlin <[email protected]> Authored: Sat Jul 25 01:12:07 2015 +0200 Committer: Paul Merlin <[email protected]> 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 [email protected]. 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" ----
