This is an automated email from the ASF dual-hosted git repository.
tison pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/pulsar-site.git
The following commit(s) were added to refs/heads/main by this push:
new c66eb2041a8 better content order for Update the site
c66eb2041a8 is described below
commit c66eb2041a89242fdd50ce7d4f075016cab52222
Author: tison <[email protected]>
AuthorDate: Sat Dec 31 00:23:34 2022 +0800
better content order for Update the site
Signed-off-by: tison <[email protected]>
---
contribute/release-process.md | 44 ++++++++++++++++++++++---------------------
1 file changed, 23 insertions(+), 21 deletions(-)
diff --git a/contribute/release-process.md b/contribute/release-process.md
index c7e08dea131..1c934c8cfc2 100644
--- a/contribute/release-process.md
+++ b/contribute/release-process.md
@@ -428,6 +428,26 @@ The wheel files will be generated at each platform
directory under `pulsar-clien
This step is for every release. Read the specific guide for [writing release
notes](release-note-guide.md).
+### Swagger files
+
+This step is for every release.
+
+First, build swagger files from apache/pulsar repo at the released tag:
+
+```shell
+mvn -B -ntp install -Pcore-modules,swagger,-main -DskipTests
-DskipSourceReleaseAssembly=true -Dspotbugs.skip=true -Dlicense.skip=true
+```
+
+Now, run the following script from the main branch of apache/pulsar-site repo:
+
+```shell
+cd tools/pytools
+poetry install
+poetry run bin/rest-apidoc-generator.py --master-path=/path/to/pulsar-2.X.Y
--version=2.X.Y
+```
+
+Read more on the manual of
[pytools](https://github.com/apache/pulsar-site/tree/main/tools/pytools/README.md).
+
### Javadoc
:::caution
@@ -456,7 +476,7 @@ Read more on the manual of
[pytools](https://github.com/apache/pulsar-site/tree/
:::caution
-This step is for major releases only, unless you're sure that significant
Javadoc fixes are made against the minor release.
+This step is for major releases only, unless you're sure that significant
reference fixes are made against the minor release.
:::
@@ -477,7 +497,7 @@ Read more on the manual of
[pytools](https://github.com/apache/pulsar-site/tree/
:::caution
-This step is for major releases only, unless you're sure that significant
Javadoc fixes are made against the minor release.
+This step is for major releases only, unless you're sure that significant doc
fixes are made against the minor release.
:::
@@ -497,7 +517,7 @@ Read more on the manual of
[pytools](https://github.com/apache/pulsar-site/tree/
:::caution
-This step is for major releases only, unless you're sure that significant
Javadoc fixes are made against the minor release.
+This step is for major releases only, unless you're sure that significant doc
fixes are made against the minor release.
:::
@@ -515,24 +535,6 @@ Once the docs are generated, you can add them and submit
them in a PR. The expec
Read more on the manual of
[pytools](https://github.com/apache/pulsar-site/tree/main/tools/pytools/README.md).
-### Swagger files
-
-First, build swagger files from apache/pulsar repo at the released tag:
-
-```shell
-mvn -B -ntp install -Pcore-modules,swagger,-main -DskipTests
-DskipSourceReleaseAssembly=true -Dspotbugs.skip=true -Dlicense.skip=true
-```
-
-Now, run the following script from the main branch of apache/pulsar-site repo:
-
-```shell
-cd tools/pytools
-poetry install
-poetry run bin/rest-apidoc-generator.py --master-path=/path/to/pulsar-2.X.Y
--version=2.X.Y
-```
-
-Read more on the manual of
[pytools](https://github.com/apache/pulsar-site/tree/main/tools/pytools/README.md).
-
## Update the site
Clone the apache/site repo:
