X-Git-Url: https://gerrit.simantics.org/r/gitweb?p=simantics%2Fplatform.git;a=blobdiff_plain;f=releng%2Fdoc%2Frelease.md;h=23badbcf447fc9d7b7bc96143f60708816d4b038;hp=a9a681bf22209730466fab49ca9169b33859629c;hb=70d2af523cf495a41ad1ef5a40ec56c7362e59e2;hpb=913d574c2a6a2e7dcdd0ee8922d963e3087774fd diff --git a/releng/doc/release.md b/releng/doc/release.md index a9a681bf2..23badbcf4 100644 --- a/releng/doc/release.md +++ b/releng/doc/release.md @@ -58,26 +58,42 @@ With service releases, branch from an existing `release/*` branch instead. git branch release/x.y.z[.w] remotes/origin/release/x.y.z[.w] git checkout release/x.y.z[.w] -2. Edit the beginning of the file `releng/org.simantics.sdk.build.targetdefinition/simantics.target` +2. Edit all target platform files in `releng/org.simantics.sdk.build.targetdefinition/`, i.e. + * `simantics.target` + * `org.simantics.sdk.build.targetdefinition.target` + * `org.simantics.sdk.build.targetdefinition-semantum.target` + + At the beginning of each .target file, increment `sequenceNumber` by 1 ~~~ - - - - + + ~~~ + + Next, replace the following rows in those files: + + ~~~ - + + ~~~ - * Change ` + + + ~~~ ### Initialize release branch distribution web site -* Run the [SDK/Simantics SDK](https://www.simantics.org/jenkins/job/SDK/job/Simantics SDK) build with parameters: - * `REFSPEC: refs/heads/release/x.y.z[.w]` - * `PUBLISHED_BRANCH_NAME: release/x.y.z[.w]` +* Run [SDK/Deploy External Components to Web](https://www.simantics.org/jenkins/job/SDK/job/Deploy%20External%20Components%20to%20Web/) build with parameters: + * **GERRIT_REFNAME:** `release/x.y.z[.w]` + * **PUBLISH_ARTIFACTS:** `true` +* Run the [SDK/Simantics SDK](https://www.simantics.org/jenkins/job/SDK/job/Simantics%20SDK/) build with parameters: + * **GERRIT_REFNAME:** `release/x.y.z[.w]` + * **PUBLISH_ARTIFACTS:** `true` ## Review documentation @@ -116,14 +132,13 @@ When the release branches are ready for the release, tag them with the tag `vx.y > Note The -m argument must be supplied to create an [annotated tag](https://git-scm.com/book/en/v2/Git-Basics-Tagging). > Only annotated or signed tags can be pushed to Gerrit. -## Tag documentation wikis +## Dump documentation wikis -Tag documentation wiki using [tag.sh](./tag.sh) script. +Dump documentation wiki using [dump-wikis.sh](./dump-wikis.sh) script. -The wiki documentation is mainly in MediaWiki installations. The only sane way to tag the documentation is to clone it: -* Copy the wiki installation from wiki to ${release_version}/wiki -* Copy the trunk wiki MySQL database into a new version -* Reconfigure the tagged wiki (LocalSettings.php) to use the copied database and no longer allow any edits +The wiki documentation is mainly in MediaWiki installations. The only +sane way to tag the documentation is to back up the mysql database +backing the wiki. ## Compile change log entry