Skip to content

Commit 5660c30

Browse files
authored
feature: update release verification documentation (#815)
1 parent 632c71c commit 5660c30

2 files changed

Lines changed: 20 additions & 0 deletions

File tree

website/community/release/release-version.md

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -189,6 +189,16 @@ Note: If the close operation fails, it is likely because the public key correspo
189189
190190
### 2.2.2 Package Source
191191
192+
:::caution Note
193+
Do NOT run the release process in your daily working directory!
194+
:::
195+
196+
> Local files such as `node_modules`, IDE configurations (e.g., `.idea`, `.vscode`), or leftover empty directories from refactoring can accidentally be packaged into the `source-release.zip`. This will cause compliance issues (e.g., distributing unauthorized binaries) and lead to vote failures.
197+
198+
You **MUST** perform the release process in a **fresh git clone** to ensure the artifacts are reproducible and clean.
199+
200+
**Note**: Do not open this directory with an IDE (like IntelliJ or VS Code) immediately, as it may generate configuration files or compilation caches. Run the Maven release commands directly from the terminal first.
201+
192202
First, confirm that the current codebase is ready for release.
193203
194204
```bash

website/i18n/zh-cn/docusaurus-plugin-content-docs-community/current/release/release-version.md

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -191,6 +191,16 @@ mvn clean deploy -Papache-release -DskipTests -Dgpg.skip=false
191191

192192
### 2.2.2 打包源代码 (Package Source)
193193

194+
:::caution 注意
195+
请勿在日常工作目录中运行发布流程!
196+
:::
197+
198+
> 诸如 `node_modules`、IDE 配置文件(例如 `.idea``.vscode`)或重构后残留的空目录等本地文件,可能意外被打包到 `source-release.zip` 中。这将导致合规性问题(例如分发未经授权的二进制文件),并引发投票失败。
199+
200+
**必须****全新克隆的Git仓库**中执行发布流程,以确保构建产物可复现且干净。
201+
202+
**注意**:请勿立即用IDE(如IntelliJ或VS Code)打开此目录,否则可能生成配置文件或编译缓存。请先在终端直接运行Maven发布命令。
203+
194204
首先,确认当前代码库处于准备发布的状态。
195205

196206
```bash

0 commit comments

Comments
 (0)