release doc tweaks
diff --git a/src/site/asciidoc/releasing.adoc b/src/site/asciidoc/releasing.adoc
index efa0a75..3615483 100644
--- a/src/site/asciidoc/releasing.adoc
+++ b/src/site/asciidoc/releasing.adoc
@@ -111,16 +111,17 @@
In this phase on the release branch, the poms Edgent versions are changed to the specified release version, a full build with all tests is run, and a commit is done with this state and tagged. After that the release branch poms Edgent versions are set to the first/next specified `major.minor.bugfix-SNAPSHOT` bugfix development version and this update is committed. The commits are automatically pushed.
-WARNING: at this moment the new edgent-deployment-filter-maven-plugin (EDGENT-440) is not yet released and the release:prepare below will fail with `There are still some remaining snapshot dependencies.` To work around that for the moment, add `-DignoreSnapshots` to the `mvn release:prepare` below. I'm not sure but prior to doing the prepare you may need to build the plugin and install it in your maven cache (`cd utils/edgent-deployment-filter-maven-plugin; mvn install`).
-
Prepare the release branch:
git checkout release/1.2 # the branch from "Creating the Release Branch"
+ # see note below for -DignoreSnapshots=true
mvn release:prepare -DreleaseVersion=1.2.0 -Dtag=edgent-1.2.0 -DdevelopmentVersion=1.2.1-SNAPSHOT -DautoVersionSubmodules=true -P platform-android,platform-java7,distribution
git status # should report nothing ahead/behind. Do 'git push' if needed.
+NOTE: the new edgent-deployment-filter-maven-plugin (EDGENT-440) is not yet released and the release:prepare will fail with `There are still some remaining snapshot dependencies.` Add `-DignoreSnapshots=true` to the `mvn release:prepare` to workaround that. Build the plugin first if there seem to be other issues (`cd utils/edgent-deployment-filter-maven-plugin; mvn install`).
+
Now would be a good time to update the "[DISCUSS]" thread with the branch and tag info if you so choose.
If you need to restart because of error or the process is cancelled, then run the `release:prepare` again to pick up where it left off.
@@ -157,9 +158,6 @@
git checkout release/1.2 # the branch from "Creating the release branch"
- # Hmm... does -DskipTests work with the following? Tests take a long
- # time and normally one has just gone through them all in the Prepare step.
-
mvn release:perform -DreleaseProfiles=platform-android,platform-java7
After this step is successful, a Nexus staging repository named `orgapacheedgent-####` will have been created at at https://repository.apache.org and populated with all of the release candidate's artifacts. The last four digits are generated by Nexus.
@@ -168,9 +166,6 @@
The `release:perform` stages some undesired artifacts. See EDGENT-440.
-TODO: what's needed to manually delete these? "Delete" each via the UI?
-What about the state of the metadata artifacts, do they reference those deleted items?
-
Minimally, log into Nexus and select the staging repository as described below in `Close the Staging Repository`, and manually select and delete the various `source-release` files in `org/apache/edgent/edgent-parent` using the browser UI.
=== Nexus Authentication Setup
@@ -204,7 +199,7 @@
login to https://repository.apache.org/ with your Apache credentials
select "Staging Repositories" in the section "Build Promotion"
click on the orgapacheedgent-#### staging repository
- click on the Close button
+ click on the Close button # set the description to "Apache Edgent X.Y.Z-RC<n>"
A number of pre-configured tests are executed automatically: