This is an automated email from the ASF dual-hosted git repository.
chaokunyang pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/fory-site.git
The following commit(s) were added to refs/heads/main by this push:
new dcbfaa9e update release doc after graduate to tlp (#288)
dcbfaa9e is described below
commit dcbfaa9e339a3fbcb4c6ac00be6c2e631e51e93d
Author: Shawn Yang <[email protected]>
AuthorDate: Mon Aug 11 21:54:19 2025 +0800
update release doc after graduate to tlp (#288)
---
docs/community/community.md | 9 +-
docs/community/how_to_join_community.md | 2 +-
docs/community/how_to_release.md | 187 +++++----------------
docs/community/how_to_verify.md | 15 +-
.../docusaurus-plugin-content-blog/authors.yml | 4 +-
.../docusaurus-plugin-content-blog/authors.yml | 6 +-
6 files changed, 55 insertions(+), 168 deletions(-)
diff --git a/docs/community/community.md b/docs/community/community.md
index 419a2089..b8432ccc 100644
--- a/docs/community/community.md
+++ b/docs/community/community.md
@@ -4,7 +4,6 @@ sidebar_position: 0
id: community
---
-
Apache Fory is a volunteer project and it thrives on the contributions of its
community.
We invite you to participate as much or as little as you wish. Here are
several ways to contribute:
@@ -15,10 +14,10 @@ We invite you to participate as much or as little as you
wish. Here are several
## Mailing list
-| Name | Desc |
Subscribe | Unsubscribe
| Post |
Archive |
-|-------------------------|---------------------------------------------|-------------------------------------------------------|-----------------------------------------------------------|------------------------------------|-----------------------------------------------------------------------|
-| [email protected] | Development related discussions |
[Subscribe](mailto:[email protected]) |
[Unsubscribe](mailto:[email protected]) |
[Post](mailto:[email protected]) |
[Archive](https://lists.apache.org/[email protected]) |
-| [email protected] | All commits to our repositories |
[Subscribe](mailto:[email protected]) |
[Unsubscribe](mailto:[email protected]) | Read only list
|
[Archive](https://lists.apache.org/[email protected]) |
+| Name | Desc | Subscribe
| Unsubscribe
| Post | Archive
|
+| ----------------------- | ------------------------------- |
----------------------------------------------------- |
--------------------------------------------------------- |
---------------------------------- |
--------------------------------------------------------------------- |
+| [email protected] | Development related discussions |
[Subscribe](mailto:[email protected]) |
[Unsubscribe](mailto:[email protected]) |
[Post](mailto:[email protected]) |
[Archive](https://lists.apache.org/[email protected]) |
+| [email protected] | All commits to our repositories |
[Subscribe](mailto:[email protected]) |
[Unsubscribe](mailto:[email protected]) | Read only list
|
[Archive](https://lists.apache.org/[email protected]) |
Please make sure subscribe to any list before attempting to post.
diff --git a/docs/community/how_to_join_community.md
b/docs/community/how_to_join_community.md
index a3ae4c8a..7be0f686 100644
--- a/docs/community/how_to_join_community.md
+++ b/docs/community/how_to_join_community.md
@@ -59,7 +59,7 @@ git checkout -b fix/xxxx
git checkout -b docs/add-java-demo
```
-Suppose we have created the documentation modification branch
`docs/add-java-demo` and we have added some code and submitted it to the code
repository.
+Suppose we have created the documentation modification branch
`docs/add-java-demo` and we have added some code and submitted it to the code
repository.
- `git add .`
- `git commit -a -m "docs: add java demo and related docs"`
diff --git a/docs/community/how_to_release.md b/docs/community/how_to_release.md
index e71729c5..325cb6e5 100644
--- a/docs/community/how_to_release.md
+++ b/docs/community/how_to_release.md
@@ -144,12 +144,12 @@ a [Web of
Trust](https://infra.apache.org/release-signing.html#web-of-trust).
#### Add your GPG public key to the project KEYS file
-The svn repository of the release branch is:
https://dist.apache.org/repos/dist/release/incubator/fory
+The svn repository of the release branch is:
https://dist.apache.org/repos/dist/release/fory
Please add the public key to KEYS in the release branch:
```bash
-svn co https://dist.apache.org/repos/dist/release/incubator/fory fory-dist
+svn co https://dist.apache.org/repos/dist/release/fory fory-dist
# As this step will copy all the versions, it will take some time. If the
network is broken, please use svn cleanup to delete the lock before re-execute
it.
cd fory-dist
(gpg --list-sigs [email protected] && gpg --export --armor
[email protected]) >> KEYS # Append your key to the KEYS file
@@ -169,7 +169,6 @@ It's recommended but not mandatory to read following
documents before making a r
release:
- Release policy: https://www.apache.org/legal/release-policy.html
-- Incubator release: http://incubator.apache.org/guides/releasemanagement.html
- TLP release: https://infra.apache.org/release-distribution
- Release sign: https://infra.apache.org/release-signing.html
- Release publish: https://infra.apache.org/release-publishing.html
@@ -183,19 +182,19 @@ Start a discussion about the next release via sending
email to: [email protected].
Title:
```
-[DISCUSS] Release Apache Fory(incubating) ${release_version}
+[DISCUSS] Release Apache Fory ${release_version}
```
Content:
```
-Hello, Apache Fory(incubating) Community,
+Hello, Apache Fory Community,
-This is a call for a discussion to release Apache Fory(incubating) version
${release_version}.
+This is a call for a discussion to release Apache Fory version
${release_version}.
The change lists about this release:
-https://github.com/apache/fory/compare/v0.4.1...v0.5.0
+https://github.com/apache/fory/compare/v0.12.0...v0.12.1-rc1
Please leave your comments here about this release plan. We will bump the
version in repo and start the release process after the discussion.
@@ -210,21 +209,21 @@ If the discussion goes positive, you will need to prepare
the release artifiacts
### Github branch and tag
-- Create a new branch named `releases-0.5.0`
+- Create a new branch named `releases-0.12.0`
- Bump version to `$version` by executing command `python ci/release.py
bump_version -l all -version $version`
- Make a git commit and push the branch to `[email protected]:apache/fory.git`
-- Create a new tag by `git tag v0.5.0-rc1`, then push it to
`[email protected]:apache/fory.git`
+- Create a new tag by `git tag v0.12.0-rc1`, then push it to
`[email protected]:apache/fory.git`
### Build and upload artifacts to SVN dist/dev repo
First you need to build source release artifacts by `python ci/release.py
build -v $version`.
Then you need to upload it to svn dist repo. The dist repo of the dev branch
-is: https://dist.apache.org/repos/dist/dev/incubator/fory
+is: https://dist.apache.org/repos/dist/dev/fory
```bash
# As this step will copy all the versions, it will take some time. If the
network is broken, please use svn cleanup to delete the lock before re-execute
it.
-svn co https://dist.apache.org/repos/dist/dev/incubator/fory fory-dist-dev
+svn co https://dist.apache.org/repos/dist/dev/fory fory-dist-dev
```
Then, upload the artifacts:
@@ -245,7 +244,7 @@ svn status
svn commit -m "Prepare for fory ${release_version}-${rc_version}"
```
-Visit https://dist.apache.org/repos/dist/dev/incubator/fory/ to check the
artifacts are uploaded correctly.
+Visit https://dist.apache.org/repos/dist/dev/fory/ to check the artifacts are
uploaded correctly.
### What to do if something goes wrong
@@ -255,10 +254,10 @@ If some files are unexpected, you need to remove by `svn
delete` and repeat the
### check version
-As an incubating project, Fory requires votes from both the Fory Community and
Incubator Community.
+Fory requires votes from the Fory Community.
-- release_version: the version for fory, like 0.5.0.
-- release_candidate_version: the version for voting, like 0.5.0-rc1.
+- release_version: the version for fory, like 0.12.0.
+- release_candidate_version: the version for voting, like 0.12.0-rc1.
- maven_artifact_number: the number for Maven staging artifacts, like 1001.
Specifically, the maven_artifact_number can
be found by searching "fory" on
https://repository.apache.org/#stagingRepositories.
@@ -317,7 +316,7 @@ Steps to encrypt your password:
```
-2. Encrypt your Apache account password:
+4. Encrypt your Apache account password:
```sh
@@ -399,7 +398,7 @@ These steps ensure all published artifacts are verified and
correctly deployed t
### build a Pre-release
You need to build a Pre-release before voting, such as:
-https://github.com/apache/fory/releases/tag/v0.11.2-rc1
+https://github.com/apache/fory/releases/tag/v0.12.0-rc1
### Fory Community Vote
@@ -408,41 +407,41 @@ you need send a email to Fory Community:
[email protected]:
Title:
```
-[VOTE] Release Apache Fory(incubating) v${release_version}-${rc_version}
+[VOTE] Release Apache Fory v${release_version}-${rc_version}
```
Content:
```
-Hello, Apache Fory(incubating) Community:
+Hello, Apache Fory Community:
-This is a call for vote to release Apache Fory(Incubating)
+This is a call for vote to release Apache Fory
version release-${release_version}-${rc_version}.
-Apache Fory(incubating) - A blazingly fast multi-language serialization
+Apache Fory - A blazingly fast multi-language serialization
framework powered by JIT and zero-copy.
The discussion thread:
https://lists.apache.org/thread/xxr3od301g6v3ndj14zqc05byp9qvclh
The change lists about this release:
-https://github.com/apache/fory/compare/v0.4.1...v0.5.0-rc3
+https://github.com/apache/fory/compare/v0.12.0...v0.12.1-rc1
The release candidates:
-https://dist.apache.org/repos/dist/dev/incubator/fory/0.5.0-rc3/
+https://dist.apache.org/repos/dist/dev/fory/0.5.0-rc3/
The maven staging for this release:
https://repository.apache.org/content/repositories/orgapachefory-1003
Git tag for the release:
-https://github.com/apache/fory/releases/tag/v0.5.0-rc3
+https://github.com/apache/fory/releases/tag/v0.12.0-rc1
Git commit for the release:
https://github.com/apache/fory/commit/fae06330edd049bb960536e978a45b97bca66faf
The artifacts signed with PGP key [5E580BA4], corresponding to
[[email protected]], that can be found in keys file:
-https://downloads.apache.org/incubator/fory/KEYS
+https://downloads.apache.org/fory/KEYS
The vote will be open for at least 72 hours until the necessary number of
votes are reached.
@@ -464,9 +463,6 @@ To learn more about Fory, please see
https://fory.apache.org/
[ ] No compiled archives bundled in source archive.
[ ] Can compile from source.
-More detail checklist please refer:
-https://cwiki.apache.org/confluence/display/INCUBATOR/Incubator+Release+Checklist
-
How to Build and Test, please refer to:
https://github.com/apache/fory/blob/main/docs/guide/DEVELOPMENT.md
@@ -480,7 +476,7 @@ first, reply to the above voting thread to notify that the
voting has ended.
```
Hi all,
-The vote for Release Apache Fory(incubating) v${release_version}-${rc_version}
is closed now.
+The vote for Release Apache Fory v${release_version}-${rc_version} is closed
now.
Thanks to everyone for helping checking and voting for the release.
@@ -495,15 +491,15 @@ Immediately afterward, launch a new voting thread to
claim the voting results.
Title:
```
-[RESULT][VOTE] Release Apache Fory(incubating)
v${release_version}-${rc_version}
+[RESULT][VOTE] Release Apache Fory v${release_version}-${rc_version}
```
Content:
```
-Hello, Apache Fory(incubating) Community,
+Hello, Apache Fory Community,
-The vote to release Apache Fory(Incubating) v${release_version}-${rc_version}
has passed.
+The vote to release Apache Fory v${release_version}-${rc_version} has passed.
The vote PASSED with 3 binding +1 and 0 -1 vote:
@@ -520,111 +516,6 @@ Thanks,
${name}
```
-### Incubator Community Vote
-
-Send an email to: [email protected]:
-
-Title:
-
-```
-[VOTE] Release Apache Fory(incubating) v${release_version}-${rc_version}
-```
-
-Content:
-
-```
-Hello everyone,
-
-This is a call for the vote to release Apache Fory(Incubating)
v${release_version}-${rc_version}.
-
-The Apache Fory community has voted and approved the release of Apache
-Fory(incubating) v${release_version}-${rc_version}. We now kindly request the
IPMC members
-review and vote for this release.
-
-Apache Fory(incubating) - A blazingly fast multi-language serialization
-framework powered by JIT and zero-copy.
-
-Fory community vote thread:
-${community_vote_thread_url}
-
-Vote result thread:
-${community_vote_result_thread_url}
-
-The release candidate:
-https://dist.apache.org/repos/dist/dev/incubator/fory/${release_version}-${rc_version}/
-
-This release has been signed with a PGP available here:
-https://downloads.apache.org/incubator/fory/KEYS
-
-Git tag for the release:
-https://github.com/apache/fory/releases/tag/v${release_version}-${rc_version}/
-
-Git commit for the release:
-https://github.com/apache/fory/commit/$xxx
-
-Maven staging repo:
-https://repository.apache.org/content/repositories/orgapachefory-${maven_artifact_number}/
-
-How to Build and Test, please refer to:
-https://github.com/apache/fory/blob/main/docs/guide/DEVELOPMENT.md
-
-Please download, verify, and test.
-
-The VOTE will pass after 3 binding approve.
-
-[ ] +1 approve
-[ ] +0 no opinion
-[ ] -1 disapprove with the reason
-
-To learn more about apache fory, please see https://fory.apache.org/
-
-Checklist for reference:
-
-[ ] Download links are valid.
-[ ] Checksums and signatures.
-[ ] LICENSE/NOTICE files exist
-[ ] No unexpected binary files
-[ ] All source files have ASF headers
-[ ] Can compile from source
-
-Thanks,
-
-${name}
-```
-
-After at least 72 hours with at least 3 +1 binding vote (from Incubator PMC
member) and no veto, claim the vote result:
-
-Title:
-
-```
-[RESULT][VOTE] Release Apache Fory(incubating)
v${release_version}-${rc_version}
-```
-
-Content:
-
-```
-Hi Incubator PMC,
-
-The vote to release Apache Fory(incubating) v${release_version}-${rc_version}
has passed with
-4 +1 binding and 3 +1 non-binding votes, no +0 or -1 votes.
-
-Binding votes：
-
-- xxx
-- yyy
-- zzz
-
-Non-Binding votes:
-
-- aaa
-
-Vote thread: ${incubator_vote_thread_url}
-
-Thanks for reviewing and voting for our release candidate.
-
-We will proceed with publishing the approved artifacts and sending out the
announcement soon.
-```
-
### What if vote fail
If the vote failed, click "Drop" to drop the staging Maven artifacts.
@@ -639,14 +530,14 @@ Address the raised issues, then bump `rc_version` and
file a new vote again.
- release_candidate_version: the version for voting, like 0.5.0-rc1
```bash
-svn mv
https://dist.apache.org/repos/dist/dev/incubator/fory/${release_version}-${rc_version}
https://dist.apache.org/repos/dist/release/incubator/fory/${release_version}
-m "Release fory ${release_version}"
+svn mv
https://dist.apache.org/repos/dist/dev/fory/${release_version}-${rc_version}
https://dist.apache.org/repos/dist/release/fory/${release_version} -m "Release
fory ${release_version}"
```
-In the repository at https://dist.apache.org/repos/dist/dev/incubator/fory/,
if any
+In the repository at https://dist.apache.org/repos/dist/dev/fory/, if any
outdated release_candidate_version are left behind when releasing the
release_version,
please clear them to keep the dev repository tidy.
-When
`https://archive.apache.org/dist/incubator/fory/0.10.0/${release_version}` is
+When `https://archive.apache.org/dist/fory/0.12.0/${release_version}` is
accessible (confirming that the release_version has been successfully released
and archived), we may clean up the previous release version in the release
repository,
leaving only the current version.
@@ -669,7 +560,7 @@ The Apache Fory team is pleased to announce the [?]
release. This is a major rel
```
2. Replace versions by upgrading old versions to new ones.
-For example, in
[install](https://fory.apache.org/docs/docs/start/install/#java) section, it is
necessary to update the documentation for both the development branch and the
latest release branch::
+ For example, in
[install](https://fory.apache.org/docs/docs/start/install/#java) section, it is
necessary to update the documentation for both the development branch and the
latest release branch::
```
<dependency>
@@ -677,7 +568,7 @@ For example, in
[install](https://fory.apache.org/docs/docs/start/install/#java)
<artifactId>fory-core</artifactId>
<version>0.11.2</version>
</dependency>
- ```
+```
#### Update Fory
@@ -687,7 +578,7 @@ like [#2207](https://github.com/apache/fury/pull/2207).
### Github officially released
You need to officially release this version in the Fory project
-Reference implementation: https://github.com/apache/fory/releases/tag/v0.11.2
+Reference implementation: https://github.com/apache/fory/releases/tag/v0.12.0
### Release Maven artifacts
@@ -702,7 +593,7 @@ Send the release announcement to [email protected] and
CC [email protected].
Title:
```
-[ANNOUNCE] Release Apache Fory(incubating) ${release_version}
+[ANNOUNCE] Release Apache Fory ${release_version}
```
Content:
@@ -710,17 +601,17 @@ Content:
```
Hi all,
-The Apache Fory(incubating) community is pleased to announce
-that Apache Fory(incubating) {release_version} has been released!
+The Apache Fory community is pleased to announce
+that Apache Fory {release_version} has been released!
-Apache Fory(incubating) - A blazingly fast multi-language serialization
+Apache Fory - A blazingly fast multi-language serialization
framework powered by JIT and zero-copy.
The release notes are available here:
https://github.com/apache/fory/releases/tag/v${release_version}
For the complete list of changes:
-https://github.com/apache/fory/compare/v0.5.0...v${release_version}
+https://github.com/apache/fory/compare/v0.12.0...v${release_version}
Apache Fory website: https://fory.apache.org/
diff --git a/docs/community/how_to_verify.md b/docs/community/how_to_verify.md
index f26dbad7..d4a871c6 100644
--- a/docs/community/how_to_verify.md
+++ b/docs/community/how_to_verify.md
@@ -4,16 +4,13 @@ sidebar_position: 0
id: how_to_verify
---
-
-For detailed check list, please refer to the [official check
list](https://cwiki.apache.org/confluence/display/INCUBATOR/Incubator+Release+Checklist)
-
## Download the candidate version
```bash
#If there is svn locally, you can clone to the local
-svn co
https://dist.apache.org/repos/dist/dev/incubator/fory/${release_version}-${rc_version}/
+svn co
https://dist.apache.org/repos/dist/dev/fory/${release_version}-${rc_version}/
# You can download the material file directly
-wget
https://dist.apache.org/repos/dist/dev/incubator/fory/${release_version}-${rc_version}/xxx.xxx
+wget
https://dist.apache.org/repos/dist/dev/fory/${release_version}-${rc_version}/xxx.xxx
```
## Verify checksums and signatures
@@ -31,7 +28,7 @@ brew install gnupg
Then import the Fory release manager's public key:
```bash
-curl https://downloads.apache.org/incubator/fory/KEYS > KEYS # Download KEYS
+curl https://downloads.apache.org/fory/KEYS > KEYS # Download KEYS
gpg --import KEYS # Import KEYS to local
# Then, trust the public key:
gpg --edit-key <KEY-used-in-this-version> # Edit the key(mentioned in vote
email)
@@ -82,7 +79,7 @@ for i in *.tar.gz; do echo $i; gpg --verify $i.asc $i; done
If something like the following appears, it means the signature is correct:
```bash
-apache-fory-incubating-0.5.0-src.tar.gz
+apache-fory-0.12.0-src.tar.gz
gpg: Signature made Wed 17 Apr 2024 11:49:45 PM CST using RSA key ID 5E580BA4
gpg: checking the trustdb
gpg: 3 marginal(s) needed, 1 complete(s) needed, PGP trust model
@@ -99,8 +96,8 @@ for i in *.tar.gz; do echo $i; sha512sum --check $i.sha512*;
done
It should output something like:
```bash
-apache-fory-incubating-0.5.0-src.tar.gz
-apache-fory-incubating-0.5.0-src.tar.gz: OK
+apache-fory-0.12.0-src.tar.gz
+apache-fory-0.12.0-src.tar.gz: OK
```
A quick way to verify above is:
diff --git a/i18n/en-us/docusaurus-plugin-content-blog/authors.yml
b/i18n/en-us/docusaurus-plugin-content-blog/authors.yml
index 594019c0..cc8d77c2 100644
--- a/i18n/en-us/docusaurus-plugin-content-blog/authors.yml
+++ b/i18n/en-us/docusaurus-plugin-content-blog/authors.yml
@@ -1,12 +1,12 @@
chaokunyang:
name: Shawn Yang
- title: Apache Fory PPMC Member
+ title: Apache Fory PMC Member
url: https://github.com/chaokunyang
image_url: /img/authors/chaokunyang.png
wangweipeng:
name: Weipeng Wang
- title: Apache Fory PPMC Member
+ title: Apache Fory PMC Member
url: https://github.com/theweipeng
image_url: /img/authors/wangweipeng.png
diff --git a/i18n/zh-CN/docusaurus-plugin-content-blog/authors.yml
b/i18n/zh-CN/docusaurus-plugin-content-blog/authors.yml
index df70ca85..c4fcb829 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-blog/authors.yml
+++ b/i18n/zh-CN/docusaurus-plugin-content-blog/authors.yml
@@ -1,12 +1,12 @@
chaokunyang:
name: Shawn Yang
- title: Apache Fory PPMC Member
+ title: Apache Fory PMC Member
url: https://github.com/chaokunyang
image_url: /img/authors/chaokunyang.png
wangweipeng:
name: Weipeng Wang
- title: Apache Fory PPMC Member
+ title: Apache Fory PMC Member
url: https://github.com/theweipeng
image_url: /img/authors/wangweipeng.png
@@ -18,6 +18,6 @@ liangliangsui:
pandalee99:
name: Pan Li
- title: Apache Fory PPMC Member
+ title: Apache Fory PMC Member
url: https://github.com/pandalee99
image_url: /img/authors/pandalee99.png
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
