Skip to content

Commit

Permalink
Updating release documentation
Browse files Browse the repository at this point in the history
  • Loading branch information
svanteschubert committed Dec 20, 2023
1 parent fa138fb commit 192fb5a
Show file tree
Hide file tree
Showing 2 changed files with 20 additions and 18 deletions.
10 changes: 6 additions & 4 deletions docs/api/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -4,15 +4,17 @@

<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>ODF Toolkit JavaDoc API</title>
<title>JavaDoc - ODF Toolkit 0.12.0</title>
</head>

<body>
<h2>ODF Toolkit JavaDoc API</h2>
<h2>JavaDoc - ODF Toolkit 0.12.0</h2>
<ul>
<li><a href="./schema2template/index.html">ODFDOM Source Code Generator (schema2template)</a></li>
<li><a href="./odfdom/index.html">ODFDOM API</a></li>
<li><a href="./odfdom-api-changes-0.11.0-0.12.0.html">ODFDOM API changes from 0.11 to 0.12</a></li>
<li><a href="./odfdom/index.html">ODFDOM</a>
&nbsp;-&nbsp;
<a href="./odfdom-api-changes-0.11.0-0.12.0.html">API changes since 0.11.0</a>
</li>
</ul>
</body>

Expand Down
28 changes: 14 additions & 14 deletions src/site/site/content/odftoolkit_website/release-guide.mdtext
Original file line number Diff line number Diff line change
Expand Up @@ -111,24 +111,24 @@ There are two kinds of releases a quick SNAPSHOT release, where the SNAPSHOT wil
```

This will checkout the tag to the target directory, build and package everything and upload the artifacts to the staging repository.
Users will download the mirrored release artifacts from machines outside TDF control. Users need to verify that the copy downloaded is identical to the original. Mirrored copies of checksums, KEYS and signature files (.asc and .md5 files) will be present on the mirrors but must never be used for verification. So, all links from the podling website to signatures, sums and [KEYS](https://github.com/tdf/odftoolkit/blob/master/KEYS) need to refer to the original documents on GitHub. See release signing guide for more information.
Users will download the mirrored release artifacts from machines outside TDF control. Users need to verify that the copy downloaded is identical to the original. Mirrored copies of checksums, KEYS and signature files (.asc and .md5 files) will be present on the mirrors but must never be used for verification. So, all links from the project website to signatures, sums and [KEYS](https://github.com/tdf/odftoolkit/blob/master/KEYS) need to refer to the original documents on GitHub. See release signing guide for more information (from Apache).

1. **Add the Git tag manually after branch rebase**
Push the branch and if the branch is rebased the tag has to be added and pushed on the correct commit manually.
For instance for 0.11.0 release the git commands looked like:
For instance for 0.12.0 release the git commands looked like:

* Adding tag (signed -s, annotated -m, previous commit -a)
* Adding tag (signed -s, annotated (unsigned) -a, with message -m)

```shell
git tag -s -a v0.11.0 4baf275b33 -m"odftoolkit-0.11.0"
git push origin v0.11.0
git tag -s -a v0.12.0 2920b36c2b -m"odftoolkit-0.12.0"
git push origin v0.12.0
```

* Deleting tag

```shell
git tag -d v0.11.0
git push origin --delete v0.11.0
git tag -d v0.12.0
git push origin --delete v0.12.0
```

1. **What to Do If Something Goes Wrong**
Expand Down Expand Up @@ -157,21 +157,21 @@ There are two kinds of releases a quick SNAPSHOT release, where the SNAPSHOT wil
1. **Send Announcements**</br> The release manager need to send announcements to odf-dev list. The sample looks like:

```shell
Subject:[ANNOUNCEMENT] "ODF Toolkit 0.11.0 Release"
Subject:[ANNOUNCEMENT] "ODF Toolkit 0.12.0 Release"
To: [email protected]
Hi all,

The ODF Toolkit team is pleased to announce the release of 0.11.0 (>=JDK 11) supporting ODF 1.2.
The ODF Toolkit team is pleased to announce the release of 0.12.0 (>=JDK 11) supporting ODF 1.2.
The list of changes is available in the release notes[1].

All new ODF Toolkit components (binary, source and JavaDoc bundles) are available as GitHub releases [2].
Or in the central Maven repository under group ID "org.odftoolkit" and version "0.11.0" [3,4,5].
Or in the central Maven repository under group ID "org.odftoolkit" and version "0.12.0" [3,4,5].

[1] ./ReleaseNotes.html
[2] https://github.com/tdf/odftoolkit/releases/tag/v0.11.0
[3] https://repo1.maven.org/maven2/org/odftoolkit/odfdom-java/0.11.0/
[4] https://repo1.maven.org/maven2/org/odftoolkit/odfvalidator/0.11.0/
[5] https://repo1.maven.org/maven2/org/odftoolkit/xslt-runner/0.11.0/
[2] https://github.com/tdf/odftoolkit/releases/tag/v0.12.0
[3] https://repo1.maven.org/maven2/org/odftoolkit/odfdom-java/0.12.0/
[4] https://repo1.maven.org/maven2/org/odftoolkit/odfvalidator/0.12.0/
[5] https://repo1.maven.org/maven2/org/odftoolkit/xslt-runner/0.12.0/
```

## Manual GitHub Release Guide
Expand Down

0 comments on commit 192fb5a

Please sign in to comment.