From 519ba4f6a8d693fea36c90f00ec59814adf5831f Mon Sep 17 00:00:00 2001
From: ian zhang <ian.zhangzhe@gmail.com>
Date: Sun, 26 Jul 2026 10:54:10 +0800
Subject: [PATCH 1/7] docs(zh-cn): improve contributing page translation
 quality
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- Translate untranslated sections (What to Help With, Creating Examples, Moving Examples)
- Fix critical mistranslation: 'please don't worry' -> 'please do not hesitate to create an issue'
- Remove content not present in English version (submodule init steps)
- Add missing content from English version (GitHub code loading explanation)
- Fix punctuation: replace English periods/commas with Chinese equivalents
- Add spaces between Chinese and English/numbers
- Shorten linkTitle from '为 Selenium 文档做贡献' to '贡献'
- Fix section title: '贡献' -> '贡献机制' (Contribution Mechanics)
- Fix typo: '推push' -> 'push'
- Unify pronoun: '你' -> '您'
- Fix CLA reference: '步骤 7' -> '步骤 8'
- Align aliases indentation with English version (2 spaces)
---
 .../documentation/about/contributing.zh-cn.md | 211 +++++++++---------
 1 file changed, 104 insertions(+), 107 deletions(-)

diff --git a/website_and_docs/content/documentation/about/contributing.zh-cn.md b/website_and_docs/content/documentation/about/contributing.zh-cn.md
index 1e2bc2f93f13..550b04628db8 100644
--- a/website_and_docs/content/documentation/about/contributing.zh-cn.md
+++ b/website_and_docs/content/documentation/about/contributing.zh-cn.md
@@ -1,109 +1,107 @@
 ---
 title: 为 Selenium 文档做贡献
-linkTitle: 为 Selenium 文档做贡献
+linkTitle: 贡献
 weight: 2
 description: >-
-    有关改进Selenium文档和代码示例的信息
-aliases: 
-        [
-          "/documentation/zh-cn/contributing/",
-          "/documentation/zh-cn/front_matter/typographical_conventions/"
-        ]
+    有关改进 Selenium 文档和代码示例的信息
+aliases: [
+  "/documentation/zh-cn/contributing/",
+  "/documentation/zh-cn/front_matter/typographical_conventions/"
+]
 ---
 
-Selenium是一个大型软件项目, 
-其网站和文档是了解事情如何工作以及学习有效利用其潜力的关键.
+Selenium 是一个大型软件项目，
+其网站和文档是了解事情如何工作以及学习有效利用其潜力的关键。
 
-该项目包含Selenium的网站和文档. 
-这是一项持续的工作(不针对任何特定版本), 
-用于提供有效使用Selenium、
-如何参与以及如何为Selenium做出贡献的更新信息.
+该项目包含 Selenium 的网站和文档。
+这是一项持续的工作（不针对任何特定版本），
+用于提供有效使用 Selenium、
+如何参与以及如何为 Selenium 做出贡献的更新信息。
 
-对网站和文档的贡献遵循以下部分中有关贡献的描述. 
+对网站和文档的贡献遵循以下部分中有关贡献的描述。
 
 ---
 
-Selenium项目欢迎每一个人的贡献. 
-您可以通过多种方式提供帮助:
+Selenium 项目欢迎每一个人的贡献。
+您可以通过多种方式提供帮助：
 
 ## 上报问题
 
-在报告新问题或评论现有问题时, 
-请确保讨论与Selenium的软件、
-其站点与文档的具体技术问题相关.
+在报告新问题或评论现有问题时，
+请确保讨论与 Selenium 的软件、
+其站点与文档的具体技术问题相关。
 
-随着时间的推移, 所有Selenium组件的变化都非常快, 
-因此这可能会导致文档过时. 
-如前所述, 如果您确实遇到这种情况, 请不要为此担心. 
-您也可能知道如何更新文档, 因此请向我们发送包含相关更改的Pull Request.
+随着时间的推移，所有 Selenium 组件的变化都非常快，
+因此这可能会导致文档过时。
+如前所述，如果您遇到这种情况，请不要犹豫，为此创建一个 issue。
+您也可能知道如何更新文档，因此请向我们发送包含相关更改的 Pull Request。
 
-如果不确定所发现的问题是否存在, 请通过以下沟通渠道进行描述 
-https://selenium.dev/support.
+如果不确定所发现的问题是否存在，请通过以下沟通渠道进行描述
+https://selenium.dev/support。
 
 
-## What to Help With
+## 帮助事项
 
-### Creating Examples
+### 创建示例
 
-Examples that need to be added are marked with: {{% badge-code %}}
+需要添加的示例会用：{{% badge-code %}} 标记
 
-We want to be able to run all of our code examples in the CI to ensure that people can copy and paste and
-execute everything on the site. So we put the code where it belongs in the
-[examples directory](https://github.com/SeleniumHQ/seleniumhq.github.io/blob/trunk/examples/).
-Each page in the documentation correlates to a test file in each of the languages, and should follow naming conventions.
-For instance examples for this page https://www.selenium.dev/documentation/webdriver/browsers/chrome/ get added in these
-files:
+我们希望能够在 CI 中运行所有代码示例，以确保人们可以复制和粘贴并
+执行网站上的所有内容。因此，我们将代码放在
+[示例目录](https://github.com/SeleniumHQ/seleniumhq.github.io/blob/trunk/examples/)中。
+文档中的每个页面对应每种语言的一个测试文件，并应遵循命名约定。
+例如，此页面 https://www.selenium.dev/documentation/webdriver/browsers/chrome/ 的示例会添加到这些
+文件中：
 * `"/examples/java/src/test/java/dev/selenium/browsers/ChromeTest.java"`
 * `"/examples/python/tests/browsers/test_chrome.py"`
 * `"/examples/dotnet/SeleniumDocs/Browsers/ChromeTest.cs"`
 * `"/examples/ruby/spec/browsers/chrome_spec.rb"`
 * `"/examples/javascript/test/browser/chromeSpecificCaps.spec.js"`
 
-Each example should get its own test. Ideally each test has an assertion that verifies the code works as intended.
-Once the code is copied to its own test in the proper file, it needs to be referenced in the markdown file.
+每个示例应有自己的测试。理想情况下，每个测试都有一个断言来验证代码按预期工作。
+一旦代码被复制到正确文件中的测试中，就需要在 markdown 文件中引用它。
 
-For example, the tab in Ruby would look like this:
+例如，Ruby 中的 tab 看起来像这样：
 
         {{</* tab header="Ruby" */>}}
         {{</* gh-codeblock path="/examples/ruby/spec/browsers/chrome_spec.rb#L8-L9" */>}}
         {{</* /tab */>}}
 
-The line numbers at the end represent only the line or lines of code that actually represent the item being displayed.
-If a user wants more context, they can click the link to the GitHub page that will show the full context.
+末尾的行号仅代表实际显示项的代码行。
+如果用户需要更多上下文，可以点击链接到 GitHub 页面，该页面将显示完整上下文。
 
-Make sure that if you add a test to the page that all the other line numbers in the markdown file are still
-correct. Adding a test at the top of a page means updating every single reference in the documentation that has a line
-number for that file.
+确保如果在页面中添加测试，markdown 文件中的所有其他行号仍然
+正确。在页面顶部添加测试意味着更新文档中所有引用该文件行号的地方。
 
-Code examples may need a relevant website or web page to demonstrate the scenario. To ensure examples consistently work,
-it is recommended to use the test web pages available at https://www.selenium.dev/selenium/web/.
+代码示例可能需要相关的网站或网页来演示场景。为确保示例始终有效，
+建议使用 https://www.selenium.dev/selenium/web/ 中提供的测试网页。
 
-Finally, make sure that the tests pass in the CI.
+最后，确保测试在 CI 中通过。
 
 
-### Moving Examples
+### 迁移示例
 
-Examples that need to be moved are marked with: {{% badge-examples %}}
+需要迁移的示例会用：{{% badge-examples %}} 标记
 
-Everything from the [Creating Examples](#creating-examples) section applies, with one addition.
+[创建示例](#创建示例) 部分的所有内容都适用，但有一处补充。
 
-Make sure the tab includes `text=true`. By default, the tabs get formatted
-for code, so to use markdown or other shortcode statements (like `gh-codeblock`) it needs to be declared as text.
-For most examples, the `tabpane` declares the `text=true`, but if some of the tabs have code examples, the `tabpane`
-cannot specify it, and it must be specified in the tabs that do not need automatic code formatting.
+确保 tab 包含 `text=true`。默认情况下，tab 会格式化为
+代码，因此要使用 markdown 或其他 shortcode 语句（如 `gh-codeblock`），需要将其声明为文本。
+对于大多数示例，`tabpane` 会声明 `text=true`，但如果某些 tab 包含代码示例，则 `tabpane`
+不能指定它，而必须在不需要自动代码格式化的 tab 中指定。
 
 
-## 贡献
+## 贡献机制
 
-Selenium项目欢迎新的贡献者. 
-随时间做出重大贡献的个人将成为 _提交者_ , 并获得对该项目的提交权限.
+Selenium 项目欢迎新的贡献者。
+随时间做出重大贡献的个人将成为 _提交者_，并获得对该项目的提交权限。
 
-本指南将指导您完成贡献的过程.
+本指南将指导您完成贡献的过程。
 
-### 步骤 1: Fork
+### 步骤 1：Fork
 
-在 [GitHub](https://github.com/seleniumhq/seleniumhq.github.io)上Fork本项目, 
-并check out到您的本地
+在 [GitHub](https://github.com/seleniumhq/seleniumhq.github.io) 上 Fork 本项目，
+并检出到您的本地
 
 
 ```shell
@@ -111,66 +109,65 @@ Selenium项目欢迎新的贡献者.
 % cd seleniumhq.github.io
 ```
 
-#### 依赖: Hugo
+#### 依赖：Hugo
 
 我们使用 [Hugo](https://gohugo.io/) 和 [Docsy theme](https://www.docsy.dev/)
-用于构建和渲染本网站. 
-你需要Hugo“extended”扩展的Sass/SCSS版本用于这个网站.
-我们推荐使用Hugo 0.148.2 .
+用于构建和渲染本网站。
+您需要 Hugo "extended" 扩展的 Sass/SCSS 版本用于这个网站。
+我们推荐使用 Hugo 0.148.2。
 
-请参考来自Docsy的说明
-[安装Hugo](https://www.docsy.dev/docs/getting-started/#install-hugo) .
+请参考来自 Docsy 的说明
+[安装 Hugo](https://www.docsy.dev/docs/getting-started/#install-hugo)。
 
-### 步骤 2: 分支
+### 步骤 2：分支
 
-创建一个功能分支并开始工作:
+创建一个功能分支并开始工作：
 
 ```shell
 % git checkout -b my-feature-branch
 ```
 
-我们实践基于HEAD的开发模式, 这意味着所有更改都直接应用在trunk之上.
+我们实践基于 HEAD 的开发模式，这意味着所有更改都直接应用在 trunk 之上。
 
-### 步骤 3: 做出改变
+### 步骤 3：做出改变
 
-本仓库包含站点和文档.
-在开始进行更改之前,
-请初始化子模块并安装所需的依赖项
-(请参阅下面的命令).
-要对网站进行更改, 
-请使用 `website_and_docs` 目录.
-要查看更改的实时预览, 
-请在站点的根目录上运行 `hugo server` .
+本仓库包含站点和文档。
+要对网站进行更改，
+请使用 `website_and_docs` 目录。
+要查看更改的实时预览，
+请在站点的根目录上运行 `hugo server`。
 
 ```shell
-% git submodule update --init --recursive
 % cd website_and_docs
 % hugo server
 ```
 
-请参阅 [样式指南]({{< ref "style.md" >}}) , 
+项目会从 GitHub 加载代码，如果代码已更新但
+未在预览中反映出来，您可以不使用缓存运行 hugo：`hugo server --ignoreCache`
+
+请参阅 [样式指南]({{< ref "style.md" >}})，
 以了解更多关于我们约定的信息
 
-### 步骤 4: 提交
+### 步骤 4：提交
 
-首先确保git知道您的姓名和电子邮件地址:
+首先确保 git 知道您的姓名和电子邮件地址：
 
 ```shell
 % git config --global user.name 'Santa Claus'
 % git config --global user.email 'santa@example.com'
 ```
 
-**编写良好的提交信息很重要.** 
-提交信息应描述更改的内容, 
-原因以及已解决的参考问题(如果有). 
-撰写时应遵循以下规则:
+**编写良好的提交信息很重要。**
+提交信息应描述更改的内容，
+原因以及已解决的参考问题（如果有）。
+撰写时应遵循以下规则：
 
-1. 第一行应少于或等于50个字符, 并包含对该更改的简短说明.
-2. 保持第二行空白.
-3. 在所有72列处换行.
-4. 包括 `Fixes #N`, 其中 _N_ 是提交修复的问题编号(如果有).
+1. 第一行应少于或等于 50 个字符，并包含对该更改的简短说明。
+2. 保持第二行空白。
+3. 在所有 72 列处换行。
+4. 包括 `Fixes #N`，其中 _N_ 是提交修复的问题编号（如果有）。
 
-一个好的提交信息可能看起来像这样:
+一个好的提交信息可能看起来像这样：
 
 ```text
 explain commit normatively in one line
@@ -187,43 +184,43 @@ nicely even when it is indented.
 Fixes #141
 ```
 
-第一行必须有意义, 因为这是人们在运行 `git shortlog` 或 `git log --oneline` 时看到的内容.
+第一行必须有意义，因为这是人们在运行 `git shortlog` 或 `git log --oneline` 时看到的内容。
 
-### 步骤 5: Rebase
+### 步骤 5：Rebase
 
-使用 `git rebase` (并非 `git merge`) 同步实时的工作.
+使用 `git rebase`（并非 `git merge`）同步实时的工作。
 
 ```shell
 % git fetch origin
 % git rebase origin/trunk
 ```
 
-### 步骤 6: 测试
+### 步骤 6：测试
 
-永远记住要[运行本地服务](https://gohugo.io/getting-started/usage/#livereload), 
-这样做可以确保您的更改没有破坏任何事情. 
+永远记住要[运行本地服务](https://gohugo.io/getting-started/usage/#livereload)，
+这样做可以确保您的更改没有破坏任何事情。
 
-### 步骤 7: Push
+### 步骤 7：Push
 
 ```shell
 % git push origin my-feature-branch
 ```
 
 访问 https://github.com/yourusername/seleniumhq.github.io.git
-并点击 _Pull Request_ 以及填写表格.
- **请明确您已经签署了CLA** (详见步骤 7).
+并点击 _Pull Request_ 以及填写表格。
+**请明确您已经签署了 CLA**（详见步骤 8）。
 
-Pull requests通常会在几天内进行审核. 
-如果有评论要解决, 请在新提交(最好是[修正](http://git-scm.com/docs/git-commit))中应用您的更改, 
-然后推push到同一分支.
+Pull Request 通常会在几天内进行审核。
+如果有评论要解决，请在新提交（最好是[修正](http://git-scm.com/docs/git-commit)）中应用您的更改，
+然后 push 到同一分支。
 
-### 步骤 8: 集成
+### 步骤 8：集成
 
-代码审查完成后, 提交者将获取您的PR并将其集成到项目的trunk分支中. 
-因为我们希望在trunk分支上保持线性历史记录, 
-所以我们通常会squash并rebase您的分支历史记录.
+代码审查完成后，提交者将获取您的 PR 并将其集成到项目的 trunk 分支中。
+因为我们希望在 trunk 分支上保持线性历史记录，
+所以我们通常会 squash 并 rebase 您的分支历史记录。
 
 ## 沟通
 
-有关如何与项目贡献者和整个社区进行沟通的所有详细信息, 
+有关如何与项目贡献者和整个社区进行沟通的所有详细信息，
 请访问以下网址 https://selenium.dev/support

From b41ee70ba2364c95eec0266b98d9a201c1731897 Mon Sep 17 00:00:00 2001
From: ian zhang <ian.zhangzhe@gmail.com>
Date: Sun, 26 Jul 2026 11:03:09 +0800
Subject: [PATCH 2/7] docs(zh-cn): fix translation errors against English
 source
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- Title: add missing 'site' (站点) to match 'site & documentation'
- Fix 'ask' mistranslated as '描述' -> '询问' (line 39)
- Add missing 'valuable' -> '重大且有价值的贡献' (line 97)
- Fix 'dev' mistranslated as 'trunk' -> 'dev' (line 130)
- Add missing 'for contribution' -> '贡献规范' (line 148)
- Fix 'reference issues fixed' -> '引用已修复的问题' (line 162)
- Fix 'around 50' -> '大约 50 个字符或更少' (line 165)
- Add missing 'all other lines' -> '所有其他行' (line 167)
- Fix 'from time to time' mistranslated as '实时的' -> '不时地' (line 191)
---
 .../documentation/about/contributing.zh-cn.md    | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)

diff --git a/website_and_docs/content/documentation/about/contributing.zh-cn.md b/website_and_docs/content/documentation/about/contributing.zh-cn.md
index 550b04628db8..41e8ae488929 100644
--- a/website_and_docs/content/documentation/about/contributing.zh-cn.md
+++ b/website_and_docs/content/documentation/about/contributing.zh-cn.md
@@ -1,5 +1,5 @@
 ---
-title: 为 Selenium 文档做贡献
+title: 为 Selenium 站点和文档做贡献
 linkTitle: 贡献
 weight: 2
 description: >-
@@ -36,8 +36,8 @@ Selenium 项目欢迎每一个人的贡献。
 如前所述，如果您遇到这种情况，请不要犹豫，为此创建一个 issue。
 您也可能知道如何更新文档，因此请向我们发送包含相关更改的 Pull Request。
 
-如果不确定所发现的问题是否存在，请通过以下沟通渠道进行描述
-https://selenium.dev/support。
+如果不确定所发现的问题是否存在，请通过
+https://selenium.dev/support 中描述的沟通渠道进行询问。
 
 
 ## 帮助事项
@@ -94,7 +94,7 @@ https://selenium.dev/support。
 ## 贡献机制
 
 Selenium 项目欢迎新的贡献者。
-随时间做出重大贡献的个人将成为 _提交者_，并获得对该项目的提交权限。
+随时间做出重大且有价值的贡献的个人将成为 _提交者_，并获得对该项目的提交权限。
 
 本指南将指导您完成贡献的过程。
 
@@ -127,7 +127,7 @@ Selenium 项目欢迎新的贡献者。
 % git checkout -b my-feature-branch
 ```
 
-我们实践基于 HEAD 的开发模式，这意味着所有更改都直接应用在 trunk 之上。
+我们实践基于 HEAD 的开发模式，这意味着所有更改都直接应用在 `dev` 之上。
 
 ### 步骤 3：做出改变
 
@@ -159,10 +159,10 @@ Selenium 项目欢迎新的贡献者。
 
 **编写良好的提交信息很重要。**
 提交信息应描述更改的内容，
-原因以及已解决的参考问题（如果有）。
+原因以及引用已修复的问题（如果有）。
 撰写时应遵循以下规则：
 
-1. 第一行应少于或等于 50 个字符，并包含对该更改的简短说明。
+1. 第一行应大约 50 个字符或更少，并包含对该更改的简短说明。
 2. 保持第二行空白。
 3. 在所有 72 列处换行。
 4. 包括 `Fixes #N`，其中 _N_ 是提交修复的问题编号（如果有）。
@@ -188,7 +188,7 @@ Fixes #141
 
 ### 步骤 5：Rebase
 
-使用 `git rebase`（并非 `git merge`）同步实时的工作。
+使用 `git rebase`（而非 `git merge`）不时地同步您的工作。
 
 ```shell
 % git fetch origin

From d11f636a67d79003691065f9a321563968be749f Mon Sep 17 00:00:00 2001
From: ian zhang <ian.zhangzhe@gmail.com>
Date: Sun, 26 Jul 2026 11:10:21 +0800
Subject: [PATCH 3/7] docs: add CLA signing instructions to all contributing
 pages
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- Remove incorrect '(see Step 7)' / '(ステップ7を参照)' / '(consulte a Etapa 7)' self-references
- Add CLA signing instructions: visit https://cla-assistant.io/SeleniumHQ/seleniumhq.github.io and click 'Sign in with GitHub to agree' button
- Update all 4 language versions: en, zh-cn, ja, pt-br
---
 .../content/documentation/about/contributing.en.md            | 4 +++-
 .../content/documentation/about/contributing.ja.md            | 2 +-
 .../content/documentation/about/contributing.pt-br.md         | 4 +++-
 .../content/documentation/about/contributing.zh-cn.md         | 4 +++-
 4 files changed, 10 insertions(+), 4 deletions(-)

diff --git a/website_and_docs/content/documentation/about/contributing.en.md b/website_and_docs/content/documentation/about/contributing.en.md
index 3179ff9788ac..43b7c88fbbc7 100644
--- a/website_and_docs/content/documentation/about/contributing.en.md
+++ b/website_and_docs/content/documentation/about/contributing.en.md
@@ -214,7 +214,9 @@ with this you can be sure that your changes have not broken anything.
 
 Go to https://github.com/yourusername/seleniumhq.github.io.git and
 press the _Pull Request_ and fill out the form. **Please indicate
-that you've signed the CLA** (see Step 7).
+that you've signed the CLA**. To sign the CLA, visit
+https://cla-assistant.io/SeleniumHQ/seleniumhq.github.io and click the
+"Sign in with GitHub to agree" button on the page.
 
 Pull requests are usually reviewed within a few days. If there are
 comments to address, apply your changes in new commits (preferably
diff --git a/website_and_docs/content/documentation/about/contributing.ja.md b/website_and_docs/content/documentation/about/contributing.ja.md
index 3596dad32f9c..fcf446928033 100644
--- a/website_and_docs/content/documentation/about/contributing.ja.md
+++ b/website_and_docs/content/documentation/about/contributing.ja.md
@@ -177,7 +177,7 @@ Fixes #141
 % git push origin my-feature-branch
 ```
 
-https://github.com/yourusername/seleniumhq.github.io.git を開き、 _Pull Request_ を押し、フォームを入力してください。 **CLAに署名したことを示してください** (ステップ7を参照)
+https://github.com/yourusername/seleniumhq.github.io.git を開き、 _Pull Request_ を押し、フォームを入力してください。 **CLAに署名したことを示してください**。CLAに署名するには、https://cla-assistant.io/SeleniumHQ/seleniumhq.github.io にアクセスし、ページ上の"Sign in with GitHub to agree"ボタンをクリックしてください。
 
 プルリクエストは通常数日以内にレビューされます。対応すべきコメントがある場合は、新しく(できれば
 [fixups](http://git-scm.com/docs/git-commit)で)コミットし、同じブランチにプッシュしてください。
diff --git a/website_and_docs/content/documentation/about/contributing.pt-br.md b/website_and_docs/content/documentation/about/contributing.pt-br.md
index e646627ae5a5..e373a964a589 100644
--- a/website_and_docs/content/documentation/about/contributing.pt-br.md
+++ b/website_and_docs/content/documentation/about/contributing.pt-br.md
@@ -214,7 +214,9 @@ com isso, você pode ter certeza de que suas alterações não prejudicaram nada
 
 Acesse https://github.com/yourusername/seleniumhq.github.io.git e
 clique em _Pull Request_ e preencha o formulário. **Por favor indique
-que você assinou o CLA** (consulte a Etapa 7).
+que você assinou o CLA**. Para assinar o CLA, visite
+https://cla-assistant.io/SeleniumHQ/seleniumhq.github.io e clique no botão
+"Sign in with GitHub to agree" na página.
 
 Os Pull Requests geralmente são revisados em alguns dias. Se houver
 comentários a abordar, aplique suas alterações em novos commits (de preferência
diff --git a/website_and_docs/content/documentation/about/contributing.zh-cn.md b/website_and_docs/content/documentation/about/contributing.zh-cn.md
index 41e8ae488929..1e9b74359063 100644
--- a/website_and_docs/content/documentation/about/contributing.zh-cn.md
+++ b/website_and_docs/content/documentation/about/contributing.zh-cn.md
@@ -208,7 +208,9 @@ Fixes #141
 
 访问 https://github.com/yourusername/seleniumhq.github.io.git
 并点击 _Pull Request_ 以及填写表格。
-**请明确您已经签署了 CLA**（详见步骤 8）。
+**请明确您已经签署了 CLA**。要签署 CLA，请访问
+https://cla-assistant.io/SeleniumHQ/seleniumhq.github.io 并点击页面上的
+"Sign in with GitHub to agree" 按钮。
 
 Pull Request 通常会在几天内进行审核。
 如果有评论要解决，请在新提交（最好是[修正](http://git-scm.com/docs/git-commit)）中应用您的更改，

From 4764d7f9b1a48706ef19b61f09fae3c863333b8f Mon Sep 17 00:00:00 2001
From: ian zhang <ian.zhangzhe@gmail.com>
Date: Sun, 26 Jul 2026 11:18:50 +0800
Subject: [PATCH 4/7] docs: use markdown link for CLA URL and apply semantic
 linefeeds

- Replace bare URL with markdown link [text](url) format
- Apply semantic linefeeds per style guide (~100 chars per line)
- Update all 4 language versions: en, zh-cn, ja, pt-br
---
 .../content/documentation/about/contributing.en.md          | 4 ++--
 .../content/documentation/about/contributing.ja.md          | 6 +++++-
 .../content/documentation/about/contributing.pt-br.md       | 4 ++--
 .../content/documentation/about/contributing.zh-cn.md       | 4 ++--
 4 files changed, 11 insertions(+), 7 deletions(-)

diff --git a/website_and_docs/content/documentation/about/contributing.en.md b/website_and_docs/content/documentation/about/contributing.en.md
index 43b7c88fbbc7..ec9fdc962aff 100644
--- a/website_and_docs/content/documentation/about/contributing.en.md
+++ b/website_and_docs/content/documentation/about/contributing.en.md
@@ -215,8 +215,8 @@ with this you can be sure that your changes have not broken anything.
 Go to https://github.com/yourusername/seleniumhq.github.io.git and
 press the _Pull Request_ and fill out the form. **Please indicate
 that you've signed the CLA**. To sign the CLA, visit
-https://cla-assistant.io/SeleniumHQ/seleniumhq.github.io and click the
-"Sign in with GitHub to agree" button on the page.
+[cla-assistant.io/SeleniumHQ/seleniumhq.github.io](https://cla-assistant.io/SeleniumHQ/seleniumhq.github.io)
+and click the "Sign in with GitHub to agree" button on the page.
 
 Pull requests are usually reviewed within a few days. If there are
 comments to address, apply your changes in new commits (preferably
diff --git a/website_and_docs/content/documentation/about/contributing.ja.md b/website_and_docs/content/documentation/about/contributing.ja.md
index fcf446928033..f07ec09704c5 100644
--- a/website_and_docs/content/documentation/about/contributing.ja.md
+++ b/website_and_docs/content/documentation/about/contributing.ja.md
@@ -177,7 +177,11 @@ Fixes #141
 % git push origin my-feature-branch
 ```
 
-https://github.com/yourusername/seleniumhq.github.io.git を開き、 _Pull Request_ を押し、フォームを入力してください。 **CLAに署名したことを示してください**。CLAに署名するには、https://cla-assistant.io/SeleniumHQ/seleniumhq.github.io にアクセスし、ページ上の"Sign in with GitHub to agree"ボタンをクリックしてください。
+https://github.com/yourusername/seleniumhq.github.io.git を開き、 _Pull Request_ を押し、
+フォームを入力してください。 **CLAに署名したことを示してください**。
+CLAに署名するには、
+[cla-assistant.io/SeleniumHQ/seleniumhq.github.io](https://cla-assistant.io/SeleniumHQ/seleniumhq.github.io)
+にアクセスし、ページ上の"Sign in with GitHub to agree"ボタンをクリックしてください。
 
 プルリクエストは通常数日以内にレビューされます。対応すべきコメントがある場合は、新しく(できれば
 [fixups](http://git-scm.com/docs/git-commit)で)コミットし、同じブランチにプッシュしてください。
diff --git a/website_and_docs/content/documentation/about/contributing.pt-br.md b/website_and_docs/content/documentation/about/contributing.pt-br.md
index e373a964a589..3885b09b3443 100644
--- a/website_and_docs/content/documentation/about/contributing.pt-br.md
+++ b/website_and_docs/content/documentation/about/contributing.pt-br.md
@@ -215,8 +215,8 @@ com isso, você pode ter certeza de que suas alterações não prejudicaram nada
 Acesse https://github.com/yourusername/seleniumhq.github.io.git e
 clique em _Pull Request_ e preencha o formulário. **Por favor indique
 que você assinou o CLA**. Para assinar o CLA, visite
-https://cla-assistant.io/SeleniumHQ/seleniumhq.github.io e clique no botão
-"Sign in with GitHub to agree" na página.
+[cla-assistant.io/SeleniumHQ/seleniumhq.github.io](https://cla-assistant.io/SeleniumHQ/seleniumhq.github.io)
+e clique no botão "Sign in with GitHub to agree" na página.
 
 Os Pull Requests geralmente são revisados em alguns dias. Se houver
 comentários a abordar, aplique suas alterações em novos commits (de preferência
diff --git a/website_and_docs/content/documentation/about/contributing.zh-cn.md b/website_and_docs/content/documentation/about/contributing.zh-cn.md
index 1e9b74359063..1875a6cd993b 100644
--- a/website_and_docs/content/documentation/about/contributing.zh-cn.md
+++ b/website_and_docs/content/documentation/about/contributing.zh-cn.md
@@ -209,8 +209,8 @@ Fixes #141
 访问 https://github.com/yourusername/seleniumhq.github.io.git
 并点击 _Pull Request_ 以及填写表格。
 **请明确您已经签署了 CLA**。要签署 CLA，请访问
-https://cla-assistant.io/SeleniumHQ/seleniumhq.github.io 并点击页面上的
-"Sign in with GitHub to agree" 按钮。
+[cla-assistant.io/SeleniumHQ/seleniumhq.github.io](https://cla-assistant.io/SeleniumHQ/seleniumhq.github.io)
+并点击页面上的 "Sign in with GitHub to agree" 按钮。
 
 Pull Request 通常会在几天内进行审核。
 如果有评论要解决，请在新提交（最好是[修正](http://git-scm.com/docs/git-commit)）中应用您的更改，

From 5139620c31b2477f562042fc96f9fe8ee3b62924 Mon Sep 17 00:00:00 2001
From: ian zhang <ian.zhangzhe@gmail.com>
Date: Sun, 26 Jul 2026 11:27:04 +0800
Subject: [PATCH 5/7] docs: fix Communication section URL rendering in all
 languages

- Replace bare URL with markdown link in Communication section
- Add missing period at end of zh-cn sentence
- Update all 4 language versions: en, zh-cn, ja, pt-br
---
 website_and_docs/content/documentation/about/contributing.en.md | 2 +-
 website_and_docs/content/documentation/about/contributing.ja.md | 2 +-
 .../content/documentation/about/contributing.pt-br.md           | 2 +-
 .../content/documentation/about/contributing.zh-cn.md           | 2 +-
 4 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/website_and_docs/content/documentation/about/contributing.en.md b/website_and_docs/content/documentation/about/contributing.en.md
index ec9fdc962aff..dd1d9f6ab120 100644
--- a/website_and_docs/content/documentation/about/contributing.en.md
+++ b/website_and_docs/content/documentation/about/contributing.en.md
@@ -233,4 +233,4 @@ your branch history.
 ## Communication
 
 All details on how to communicate with the project contributors
-and the community overall can be found at https://selenium.dev/support
+and the community overall can be found at [selenium.dev/support](https://selenium.dev/support)
diff --git a/website_and_docs/content/documentation/about/contributing.ja.md b/website_and_docs/content/documentation/about/contributing.ja.md
index f07ec09704c5..8a608ff5f6f3 100644
--- a/website_and_docs/content/documentation/about/contributing.ja.md
+++ b/website_and_docs/content/documentation/about/contributing.ja.md
@@ -193,4 +193,4 @@ CLAに署名するには、
 
 ## コミュニケーション
 
-プロジェクトのコントリビューターおよびコミュニティ全体と交流する方法については、全て https://selenium.dev/support で詳細が記載されています。
+プロジェクトのコントリビューターおよびコミュニティ全体と交流する方法については、全て [selenium.dev/support](https://selenium.dev/support) で詳細が記載されています。
diff --git a/website_and_docs/content/documentation/about/contributing.pt-br.md b/website_and_docs/content/documentation/about/contributing.pt-br.md
index 3885b09b3443..afc93d166343 100644
--- a/website_and_docs/content/documentation/about/contributing.pt-br.md
+++ b/website_and_docs/content/documentation/about/contributing.pt-br.md
@@ -231,4 +231,4 @@ histórico linear no `trunk`, nós normalmente iremos dar Squash & Rebase no his
 ## Comunicação
 
 Todos os detalhes sobre como se comunicar com os colaboradores do projeto
-e a comunidade em geral podem ser encontrados em https://selenium.dev/support
+e a comunidade em geral podem ser encontrados em [selenium.dev/support](https://selenium.dev/support)
diff --git a/website_and_docs/content/documentation/about/contributing.zh-cn.md b/website_and_docs/content/documentation/about/contributing.zh-cn.md
index 1875a6cd993b..a46f6ca856a3 100644
--- a/website_and_docs/content/documentation/about/contributing.zh-cn.md
+++ b/website_and_docs/content/documentation/about/contributing.zh-cn.md
@@ -225,4 +225,4 @@ Pull Request 通常会在几天内进行审核。
 ## 沟通
 
 有关如何与项目贡献者和整个社区进行沟通的所有详细信息，
-请访问以下网址 https://selenium.dev/support
+请访问 [selenium.dev/support](https://selenium.dev/support)。

From 56b9c88545218dc1782e49645c5bc7c4d7bdd3bb Mon Sep 17 00:00:00 2001
From: ian zhang <ian.zhangzhe@gmail.com>
Date: Sun, 26 Jul 2026 11:35:39 +0800
Subject: [PATCH 6/7] docs(zh-cn): fix Communication section sentence ending
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- Add missing period at end of sentence
- Align phrasing with English version ('can be found at' -> '可以在...找到')
- Revert unnecessary URL changes in en/ja/pt-br versions (keep bare URLs as-is)
---
 website_and_docs/content/documentation/about/contributing.en.md | 2 +-
 website_and_docs/content/documentation/about/contributing.ja.md | 2 +-
 .../content/documentation/about/contributing.pt-br.md           | 2 +-
 .../content/documentation/about/contributing.zh-cn.md           | 2 +-
 4 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/website_and_docs/content/documentation/about/contributing.en.md b/website_and_docs/content/documentation/about/contributing.en.md
index dd1d9f6ab120..ec9fdc962aff 100644
--- a/website_and_docs/content/documentation/about/contributing.en.md
+++ b/website_and_docs/content/documentation/about/contributing.en.md
@@ -233,4 +233,4 @@ your branch history.
 ## Communication
 
 All details on how to communicate with the project contributors
-and the community overall can be found at [selenium.dev/support](https://selenium.dev/support)
+and the community overall can be found at https://selenium.dev/support
diff --git a/website_and_docs/content/documentation/about/contributing.ja.md b/website_and_docs/content/documentation/about/contributing.ja.md
index 8a608ff5f6f3..f07ec09704c5 100644
--- a/website_and_docs/content/documentation/about/contributing.ja.md
+++ b/website_and_docs/content/documentation/about/contributing.ja.md
@@ -193,4 +193,4 @@ CLAに署名するには、
 
 ## コミュニケーション
 
-プロジェクトのコントリビューターおよびコミュニティ全体と交流する方法については、全て [selenium.dev/support](https://selenium.dev/support) で詳細が記載されています。
+プロジェクトのコントリビューターおよびコミュニティ全体と交流する方法については、全て https://selenium.dev/support で詳細が記載されています。
diff --git a/website_and_docs/content/documentation/about/contributing.pt-br.md b/website_and_docs/content/documentation/about/contributing.pt-br.md
index afc93d166343..3885b09b3443 100644
--- a/website_and_docs/content/documentation/about/contributing.pt-br.md
+++ b/website_and_docs/content/documentation/about/contributing.pt-br.md
@@ -231,4 +231,4 @@ histórico linear no `trunk`, nós normalmente iremos dar Squash & Rebase no his
 ## Comunicação
 
 Todos os detalhes sobre como se comunicar com os colaboradores do projeto
-e a comunidade em geral podem ser encontrados em [selenium.dev/support](https://selenium.dev/support)
+e a comunidade em geral podem ser encontrados em https://selenium.dev/support
diff --git a/website_and_docs/content/documentation/about/contributing.zh-cn.md b/website_and_docs/content/documentation/about/contributing.zh-cn.md
index a46f6ca856a3..a7f98e4eff33 100644
--- a/website_and_docs/content/documentation/about/contributing.zh-cn.md
+++ b/website_and_docs/content/documentation/about/contributing.zh-cn.md
@@ -225,4 +225,4 @@ Pull Request 通常会在几天内进行审核。
 ## 沟通
 
 有关如何与项目贡献者和整个社区进行沟通的所有详细信息，
-请访问 [selenium.dev/support](https://selenium.dev/support)。
+可以在 https://selenium.dev/support 找到。

From 9d75566ade8fcf7b5461f96a43ed2a143e3ec3b4 Mon Sep 17 00:00:00 2001
From: ian zhang <ian.zhangzhe@gmail.com>
Date: Sun, 26 Jul 2026 11:51:32 +0800
Subject: [PATCH 7/7] docs(zh-cn): fix branch name from dev to trunk for
 consistency

Step 2 of the Chinese contributing guide referenced dev as the base
branch, while Step 5 (rebase) and Step 8 (integration) both reference
	runk. Align Step 2 with the rest of the document and the actual
repository main branch, as flagged by Copilot and Qodo reviews.
---
 .../content/documentation/about/contributing.zh-cn.md           | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/website_and_docs/content/documentation/about/contributing.zh-cn.md b/website_and_docs/content/documentation/about/contributing.zh-cn.md
index a7f98e4eff33..0c8db1a5abe9 100644
--- a/website_and_docs/content/documentation/about/contributing.zh-cn.md
+++ b/website_and_docs/content/documentation/about/contributing.zh-cn.md
@@ -127,7 +127,7 @@ Selenium 项目欢迎新的贡献者。
 % git checkout -b my-feature-branch
 ```
 
-我们实践基于 HEAD 的开发模式，这意味着所有更改都直接应用在 `dev` 之上。
+我们实践基于 HEAD 的开发模式，这意味着所有更改都直接应用在 `trunk` 之上。
 
 ### 步骤 3：做出改变