adjusting the release guide for clarity

Author: andrus

DEV-GUIDE.md

@@ -2,55 +2,38 @@
 
 ## Releasing New Version
 
-Two submodules of this project have different release strategies.
-
-- `JJava Kernel` assembly is released using GitHub releases
-- `jupyter-jvm-basekenel` module is released on Maven Central using the oss.sonatype.org repo
+### Prerequisites
 
-Before performing a release you should check `RELEASE-NOTES.md` to see that everything intended is there.
+You will need a **JDK** >= 11 and proper credentials for the `oss-sonatype-releases` repository
 
-### Prerequisites
+### Perform the Release
 
-You need a **JDK** >= 11 and a proper credentials for the `oss-sonatype-releases` repository
+Two submodules of this project have different release strategies:
 
-### Preparing release
+- `JJava Kernel` assembly is released using GitHub releases
+- `jupyter-jvm-basekenel` module is released on Maven Central using the oss.sonatype.org repo
 
-To start a release process you could use `maven-release-plugin` as usual:
+Still everything is done through a single set of Maven commands:
 
 ```bash
-mvn release:clean
-mvn release:prepare
+# mvn release:clean
+mvn release:prepare -Prelease
+mvn release:perform -Prelease
 ```
+Go to [https://s01.oss.sonatype.org/]() and manually close and release the staging repository.
 
-These commands will create a release tag and [GitHub Actions](https://github.com/dflib/jjava/actions/workflows/release.yml) automation will create a draft release.
-(**NOTE**: this is not fully set up for now, and release creation will fail, see next section).
+Go to [GitHub Releases](https://github.com/dflib/jjava/releases) to manually edit the created draft and publish it.
 
-### Manual creation of the JJava release on GitHub
+### GitHub Publishing Notes
 
-You could create a release manually in case GitHub Action is failing.
-
-Just clone the tag created in the previous step
+While GitHub actions should automatically publish the JJava zip file to GitHub releases as a draft after the 
+`release:prepare` step, this is not yet work. If the action fails, you should release manually as follows:
 
 ```bash
-git clone https://github.com/dflib/jjava.git --branch "XXX" --depth 1
-```
-and run
-```bash
+# "XXX" is the release tag name generated by Maven above
+git switch -c XXX "XXX"
 mvn clean package
 ```
 
-Then go to [GitHub Releases](https://github.com/dflib/jjava/releases) create a new release and upload `jjava/target/jjava-XXX.zip` artifact.
-
-### Finalizing `JJava` release
-
-To finalize the JJava release you should go to the [GitHub Releases](https://github.com/dflib/jjava/releases) to manually edit the created draft and publish it.
-
-### Finalizing `jupyter-jvm-basekenel` release
-
-To finalize the `jupyter-jvm-basekenel` release run:
-
-```bash
-mvn release:perform -Prelease
-```
+Go to [GitHub Releases](https://github.com/dflib/jjava/releases) create a new release and upload `jjava/target/jjava-XXX.zip` artifact.
 
-And go to [https://s01.oss.sonatype.org/]() and manually close and release the staging repository.