Selaa lähdekoodia

update "release.adoc" and related images to reflect jmonkeyengine#2535 (#183)

Stephen Gold 2 kuukautta sitten
vanhempi
commit
e5424098c7

BIN
docs/modules/ROOT/assets/images/github/colored_icons.png


BIN
docs/modules/ROOT/assets/images/github/new_release.png


BIN
docs/modules/ROOT/assets/images/github/rerun.png


BIN
docs/modules/ROOT/assets/images/github/summary.png


BIN
docs/modules/ROOT/assets/images/sonatype/close.png


BIN
docs/modules/ROOT/assets/images/sonatype/content.png


BIN
docs/modules/ROOT/assets/images/sonatype/login.png


BIN
docs/modules/ROOT/assets/images/sonatype/login_dialog.png


BIN
docs/modules/ROOT/assets/images/sonatype/refresh.png


BIN
docs/modules/ROOT/assets/images/sonatype/repo_closed.png


BIN
docs/modules/ROOT/assets/images/sonatype/select_repo.png


BIN
docs/modules/ROOT/assets/images/sonatype/sidebar.png


+ 27 - 57
docs/modules/ROOT/pages/release.adoc

@@ -130,16 +130,18 @@ but more often you'll want to specify a release branch as the target.
 
 image::github/new_release.png[new_release.png]
 
-For the tag version, specify "v" followed by the version name.
+For the tag version, specify "v" followed by the version name
+and select "Create new tag on publish".
 This determines the name of the Git tag that will be created.
 
 For the release title, specify "jMonkeyEngine " followed by the version name.
 This field can be added or edited later.
 
-For the description, write something brief.
+For the description, write something brief
+or click on the "Generate release notes" button.
 Like the title, this field can be added or edited later.
 
-For an alpha or beta release, tick the "This is a pre-release" checkbox.
+For an alpha or beta release, tick the "Set as a pre-release" checkbox.
 This helps ensure that naive users are steered toward a stable release.
 
 CAUTION: Double-check the target branch before proceeding. Then triple-check it!
@@ -156,7 +158,7 @@ Discord provides an easy way to verify that the run has begun.
 
 * Log in to your Discord account.
 * Select the "github-builds" channel on the "jMonkeyEngine Community" server.
-* Look for a recent message from the "GitHub" bot saying
+* Look for a recent message from the "GitHub" app saying
   "[jMonkeyEngine/jmonkeyengine] New release published".
   This indicates that a run has started, not that it's complete!
 
@@ -180,86 +182,54 @@ A successful release run automatically deploys various build products:
 * It deploys the test chooser's executable (a ZIP file)
   as an asset listed under the release description at GitHub Releases.
 * It also "stages" the signed Maven artifacts to Sonatype, as a "repository".
-  However, staging to Sonatype does not make the artifacts publicly visible.
+  However, staging to Sonatype does not publish the artifacts to Maven Central.
   For that to happen,
   the staging repository must be closed and synched.
 
 == Managing Repos at Sonatype
 
 The official instructions are available from
-https://central.sonatype.org/publish/release/
+https://central.sonatype.org/publish/publish-portal-ossrh-staging-api/
 
-Browse to https://s01.oss.sonatype.org/[the Nexus Repository Manager].
+Browse to https://central.sonatype.com/[the Maven Central Repository site].
 
-Select the "Log in" link in the upper right corner of the page.
+Select the "Sign In" link in the upper right corner of the page.
 
 image::sonatype/login.png[login.png]
 
-Type your Sonatype credentials into the dialog box
-and click on the "Log In" button below.
+Type your Sonatype credentials into the text boxes
+and click on the "Continue" button below.
 
 image::sonatype/login_dialog.png[login_dialog.png]
 
-Under "Build Promotion" on the left sidebar,
-select "Staging Repositories".
+Select the "Publish" link in the upper right corner of the page.
 
 image::sonatype/sidebar.png[sidebar.png]
 
-If you don't see a freshly updated repo named "orgjmonkeyengine",
-click on the "Refresh" button occasionally until its record appears.
+If you don't see a freshly staged "org.jmonkeyengine" deployment
+on the left side of the page,
+click on the "Refresh" button occasionally until its record appears
+and its status changes to "VALIDATED".
 
-image::sonatype/refresh.png[refresh.png]
-
-Select the newly staged repo by ticking the checkbox to the left of its record.
+Select the newly staged deployment.
 
 image::sonatype/select_repo.png[select_repo.png]
 
-In the bottom half of the page,
-select the "Content" tab to browse the contents of newly staged repo.
-
-image::sonatype/content.png[content.png]
+Scroll down until you see the "Component Files" heading
+on the right side of the page and
+browse the contents of newly staged deployment.
 
-When satisfied that the staged repo is 100% complete,
-click on the "Close" button and then the "Confirm" button
-to begin the automated validation process.
+When you're satisfied the deployment is correct and complete,
+click on the "Publish" button to start the publication process.
 
 image::sonatype/close.png[close.png]
 
-Click on the "Refresh" button again.
-In the bottom half of the page,
-select the "Activity" tab to watch the progress.
-Click on the "Refresh" button occasionally
-until a "Repository closed" message appears in the progress.
-
-image::sonatype/repo_closed.png[repo_closed.png]
-
-Once the repository is closed, its artifacts become publicly
-visble at SonaType, but they aren't yet synched
-to Maven Central.
-This is your last opportunity to test the proposed release,
-using (for example)
-
-[source,groovy]
-----
-repositories {
-    maven { url 'https://s01.oss.sonatype.org/content/groups/staging' }
-    mavenCentral()
-}
-----
-
-If the staged artifacts don't work for some reason, drop them,
-address the issue(s), and start over with a new release name.
-
-To begin the synching process,
-click on the "Release" button and then the "Confirm" button.
-The process usually takes about 20 minutes.
-I don't know a good way to monitor this process.
-To detect completion, browse to
-https://repo1.maven.org/maven2/org/jmonkeyengine/jme3-core/
-and refresh the web browser until the new folder appears.
+The deployment's status should immediately change to "PUBLISHING".
+When it changes to "PUBLISHED", the process is complete.
+This usually takes about 10 minutes.
 
 Allow an additional hour or two for the new release to show up
-on https://search.maven.org[Maven Central Repository Search].
+at https://central.sonatype.com/artifact/org.jmonkeyengine/jme3-core/versions[Maven Central Repository Search].
 
 == Follow-up Tasks