This is an automated email from the ASF dual-hosted git repository.
albumenj pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/dubbo-website.git
The following commit(s) were added to refs/heads/master by this push:
new dcea74cb51b Add error code 1-9, fix typo, and move CLA signing guide
to commiter manual. (#1383)
dcea74cb51b is described below
commit dcea74cb51b2d9592df0dada838a18e9328ab44c
Author: Andy Cheung <[email protected]>
AuthorDate: Sun Aug 14 10:40:47 2022 +0800
Add error code 1-9, fix typo, and move CLA signing guide to commiter
manual. (#1383)
* Update new-contributor-guide_dev.md
* Update new-contributor-guide_dev.md (2).
* Fix case and move CLA signing guide to commiter manual.
* Update new-contributor-guide_dev.md
* Update new-contributor-guide_dev.md (2).
* Fix case and move CLA signing guide to commiter manual.
* Add error code 1-9.
* Update error code 1-9.
---
.../cla-signing-guide_dev.md | 8 +--
.../contact/contributor/become-a-committer_dev.md | 6 +-
.../contributor/new-contributor-guide_dev.md | 69 +++++++++++-----------
content/zh/docs3-v2/java-sdk/faq/1/9.md | 31 ++++++++++
4 files changed, 74 insertions(+), 40 deletions(-)
diff --git a/content/zh/blog/contact/contributor/cla-signing-guide_dev.md
b/content/zh/blog/contact/committer/cla-signing-guide_dev.md
similarity index 78%
rename from content/zh/blog/contact/contributor/cla-signing-guide_dev.md
rename to content/zh/blog/contact/committer/cla-signing-guide_dev.md
index ad5df408846..bf9691b16fb 100644
--- a/content/zh/blog/contact/contributor/cla-signing-guide_dev.md
+++ b/content/zh/blog/contact/committer/cla-signing-guide_dev.md
@@ -19,12 +19,12 @@ weight: 2
* 在打印好的文件上签字
* 扫描
* 发送一封邮件到[email protected]，并抄送给[email protected]：
- * 邮件标题为“ICLA submission”
+ * 邮件标题为 “ICLA submission”
* 请在邮件正文附上您的github账号链接
- * 请记得将您的ICLA文档放入邮件的附件里
+ * 请记得将您的 ICLA 文档放入邮件的附件里
### 空格填写必要说明
* Mailing address：首选英文格式的公司地址
-* preferred apache id(s)：如果您被邀请成为一名提交者，那么需要您填写一个apache账号，否则，可以不填
-* notify project：Dubbo（意思就是Dubbo就是通知您签署ICLA的项目）
\ No newline at end of file
+* Preferred apache id(s)：如果您被邀请成为一名提交者，那么需要您填写一个apache账号，否则，可以不填
+* Notify project：Dubbo（意思就是Dubbo就是通知您签署ICLA的项目）
\ No newline at end of file
diff --git a/content/zh/blog/contact/contributor/become-a-committer_dev.md
b/content/zh/blog/contact/contributor/become-a-committer_dev.md
index 10a4cb0244e..d0764956937 100644
--- a/content/zh/blog/contact/contributor/become-a-committer_dev.md
+++ b/content/zh/blog/contact/contributor/become-a-committer_dev.md
@@ -7,13 +7,13 @@ weight: 1
每个人都可以成为 Apache
项目的贡献者。作为一个贡献者只是意味着你对项目感兴趣并以某种方式做出贡献，从提出合理的问题（这些问题记录了项目并向开发人员提供反馈）到提供新的特性作为补丁。
-如果你成为对一个项目有价值的贡献者，你有可能被邀请成为一个 committer。committer 是
ASF（Apache软件基金会）中用来表示提交特定项目的人的术语。它给你带来对项目仓库和资源写的权限。
+如果你成为对一个项目有价值的贡献者，你有可能被邀请成为一个 Committer。Committer 是 ASF（Apache
软件基金会）中用来表示提交特定项目的人的术语。它给你带来对项目仓库和资源写的权限。
-在 Dubbo 社区，如果一个 committer 获得大量的优秀成绩，就可以被邀请加入项目管理委员会（PMC）。
+在 Dubbo 社区，如果一个 Committer 获得大量的优秀成绩，就可以被邀请加入项目管理委员会（PMC）。
当您不熟悉ASF使用的开源的开发过程时，有时难以理解的一点，就是我们更重视社区而不是代码。一个强大而健康的社区将受到尊重，成为一个有趣和有益的地方。更重要的是，一个多元化和健康的社区可以长时间的持续支持代码，即使个别公司在这个领域来来往往，也是如此。
-更多详细信息可以在[这里](https://community.apache.org/contributors/)找到。
+更多详细信息可以在 [这里](https://community.apache.org/contributors/) 找到。
### 我可以贡献什么？
diff --git a/content/zh/blog/contact/contributor/new-contributor-guide_dev.md
b/content/zh/blog/contact/contributor/new-contributor-guide_dev.md
index 28ce85b1ef9..5ce77cea225 100644
--- a/content/zh/blog/contact/contributor/new-contributor-guide_dev.md
+++ b/content/zh/blog/contact/contributor/new-contributor-guide_dev.md
@@ -10,31 +10,32 @@ weight: 2
### 邮件列表描述
-邮件列表是 Dubbo 官方推荐的讨论方式，所有与 Dubbo 相关的内容都可以在这里讨论，请点击
[issue](https://github.com/apache/dubbo/issues/1393) 了解更多关于邮件列表订阅的内容
+邮件列表是 Dubbo 官方推荐的讨论方式，所有与 Dubbo 相关的内容都可以在这里讨论，请点击
[Issue](https://github.com/apache/dubbo/issues/1393) 了解更多关于邮件列表订阅的内容
如需订阅如下邮件列表，请参考 [邮件列表订阅向导](/zh/blog/1/01/01/邮件列表订阅向导/)
* [email protected]：开发邮件列表，您在使用或者开发 Dubbo 的过程中遇到的任何问题，都可以在这里进行提问。
* [email protected]：所有的提交内容都会推送到这个邮件列表，如果您对 Dubbo 的进展感兴趣，可以订阅这个邮件列表。
-* [email protected]：所有的 JIRA
[issues](https://issues.apache.org/jira/projects/DUBBO/issues)
和修改信息都会推送到这个邮件列表。Dubbo 社区已经决定使用 github issues 代替 JIRA issues，因此大部分 issues 将由
github issues 进行跟踪。JIRA issues 用于跟踪 ASF 相关问题。
+* [email protected]：所有的 [JIRA
Issues](https://issues.apache.org/jira/projects/DUBBO/issues)
和修改信息都会推送到这个邮件列表。Dubbo 社区已经决定使用 GitHub Issues 代替 JIRA Issues，因此大部分 Issues 将由
GitHub Issues 进行跟踪。JIRA Issues 用于跟踪 ASF 相关问题。
### 报告问题
+* 非安全问题直接在 GitHub Issue 中提出，另请参考 [Issue
Template](https://github.com/apache/dubbo/blob/master/.github/ISSUE_TEMPLATE/dubbo-issue-report-template.md)
。
+* 安全问题请参考 [“反馈漏洞”](../报告安全问题) 。
-### 贡献代码
-#### 贡献流程
-此贡献流程适用于所有的Apache Dubbo社区内容，包括但不限于dubbo(主干仓库)、dubbo admin、dubbo website。
+### 贡献代码流程
+此贡献流程适用于所有的 Apache Dubbo 社区内容，包括但不限于 dubbo（主干仓库）、dubbo-admin、dubbo-website。
-以下以贡献dubbo(主干仓库)为例，详细说明贡献流程。
+以下以贡献 dubbo （主干仓库） 为例，详细说明贡献流程。
-##### 1. **fork Apache/Dubbo 项目到您的github帐号下**
+#### 1. **Fork apache/dubbo 项目到您的 GitHub 帐号下**
-##### 2. **克隆您fork的Dubbo代码仓库到您本地**
+#### 2. **克隆您 Fork 的 Dubbo 代码仓库到您本地**
```shell
git clone ${your fork dubbo repo address，for example：https://github.com/${your
github id}/dubbo.git}
cd dubbo
```
-##### 3. **添加Apache/Dubbo仓库为upstream仓库**
+#### 3. **添加 apache/dubbo 仓库为 upstream 仓库**
```shell
git remote add upstream https://github.com/apache/dubbo.git
@@ -48,60 +49,62 @@ git remote -v
git fetch origin
git fetch upstream
```
-##### 4. **我们的工作以issue为驱动，认领一个issue，或者创建一个issue并描述清楚要做什么。**
-新人推荐标记为： `good first issue` 的 issue
+#### 4. **我们的工作以 Issue 为驱动，认领个 Issue，或者创建一个 Issue 并描述清楚要做什么。**
+新人推荐标记为： `good first issue` 的 Issue
-##### 5. **选择一个开发的基础分支，通常是 master/3.1， 并基于此创建一个新的本地分支**
-master/3.1 分支是目前 3.1 版本的开发分支
+#### 5. **选择一个开发的基础分支，通常是 master / 3.0 / 3.1，并基于此创建一个新的本地分支**
+* 3.1 分支是 3.1 版本的开发分支
+* 3.0 分支是 3.0 版本的开发分支
+* master 分支是 2.7 版本的开发分支
```shell
# 从远程仓库创建分支到本地
git checkout -b up-dev-issue#${issue-number} upstream/master
```
为了避免一些不必要的麻烦，我们推荐以 "upstream" 中的分支为基础创建新的本地分支。
-可以以要做的事情的简单描述作为分支名(只要你能看懂就行)，通常情况下我们会把issue号包含到分支名中，例如上面的 checkout 命令中的。
+可以以要做的事情的简单描述作为分支名(只要你能看懂就行)，通常情况下我们会把 Issue 号包含到分支名中，例如上面的 checkout 命令中的。
-##### 6. **在本地新建的开发分支上进行各种修改**
-首先请保证您阅读并正确设置Dubbo code style， 相关内容请阅读 [编码规范](#编码规范) 。
+#### 6. **在本地新建的开发分支上进行各种修改**
+首先请保证您阅读并正确设置 Dubbo code style，相关内容请阅读 [编码规范](#编码规范) 。
-修改时请保证该本地分支上的修改仅和issue相关，并尽量细化，做到一个分支只修改一件事，一个PR只修改一件事。
+修改时请保证该本地分支上的修改仅和 Issue 相关，并尽量细化，做到一个分支只修改一件事，一个PR只修改一件事。
-可以在提交注释中添加"#issue号"，将该提交与issue关联。
+可以在提交注释中添加 "#Issue号"，将该提交与 Issue 关联。
-##### 7. **将您开发完成后的分支，上传到您fork的仓库**
+#### 7. **将您开发完成后的分支，上传到您fork的仓库**
```shell
git push origin up-dev-issue#${issue-number}
```
-##### 8. **创建 pull request**
+#### 8. **创建 Pull Request**
-* 参考[pull request
template](https://github.com/apache/dubbo/blob/master/PULL_REQUEST_TEMPLATE.md)中的检查列表
+* 参考 [Pull Request
Template](https://github.com/apache/dubbo/blob/master/PULL_REQUEST_TEMPLATE.md)
中的检查列表
-Dubbo社区将会Review您的Pull Request，并可能提出修改意见，您可以根据修改意见回到步骤6进行修改，并使用步骤7进行重新提交。
+Dubbo 社区将会 Review 您的 Pull Request，并可能提出修改意见，您可以根据修改意见回到步骤6进行修改，并使用步骤7进行重新提交。
-##### 9. **如果没有问题，Dubbo社区将会把您的修改合并，恭喜您成为Dubbo的贡献者。**
+#### 9. **如果没有问题，Dubbo 社区将会把您的修改合并，恭喜您成为 Dubbo 的贡献者。**
#### 特别说明:
* 开源项目一般都是以分支的方式工作，每件事情都创建一个分支。
* 创建分支时，不要从本地仓库里的分支里创建，而是从指向主仓库的远程仓库创建。
* 不要一直在同一个分支工作， 一个分支只做一件事情，不要在同一个分支做多件事情。
-* 一直在同一分支中修改，提交都会一直在该分支中。这样就会造成每次PR都会带着之前的所有被merge、未被merge的提交。
-* 一件事情可以是一个issue，也可以是一个issue中的部分(issue太大可以拆解)。
-* 一个分支(一件事情)只提一个PR。
-* 提了PR后，如果PR有问题需要修改，可以继续在这个PR关联的分支修改提交。在PR被merge前，向这个分支继提交都会进入这个PR。
-* 如果只是想纯更新代码，可以从主仓库提PR到你fork的仓库， 源选择主仓库里的分支，目标选你fork的仓库的分支。
-* 这种方式更新代码，你fork的仓库中会多一个提交。如果以你fork的仓库中的分支为源创建分支， 这个提交纪录会被带过去并会在PR中，
所以要以主仓库的分支为源创建分支。
-* issue 认领: 在要认领的issue中回复，明确表式你将处理这个issue。这样社区的PMC和Committer会把该issue
assign给你。当然认领前先看下这个issue有没有被别人认领了。
+* 一直在同一分支中修改，提交都会一直在该分支中。这样就会造成每次PR都会带着之前的所有被 merge、未被 merge 的提交。
+* 一件事情可以是一个 Issue，也可以是一个 Issue 中的部分 （Issue 太大可以拆解）。
+* 一个分支（一件事情）只提一个PR。
+* 提了 PR 后，如果 PR 有问题需要修改，可以继续在这个 PR 关联的分支修改提交。在 PR 被 merge 前，向这个分支继提交都会进入这个 PR。
+* 如果只是想纯更新代码，可以从主仓库提 PR 到你fork的仓库，源选择主仓库里的分支，目标选你 fork 的仓库的分支。
+* 这种方式更新代码，你 Fork 的仓库中会多一个提交。如果以你 Fork 的仓库中的分支为源创建分支，
这个提交纪录会被带过去并出现在PR中，所以要以主仓库的分支为源创建分支。
+* Issue 认领: 在要认领的 Issue 中回复，明确表式你将处理这个 Issue。这样社区的 PMC 和 Committer 会把该 Issue
assign 给你。当然认领前先看下这个 Issue 有没有被别人认领了。
为了方便，我们可以把认领的回复统一为: **@i will solve it@**， 当然这不是必须的。
#### 编码规范
-请按照[CONTRIBUTING.md](https://github.com/apache/dubbo/blob/master/CONTRIBUTING.md)中的编码规范对自己的代码进行检查。
+请按照
[CONTRIBUTING.md](https://github.com/apache/dubbo/blob/master/CONTRIBUTING.md)
中的编码规范对自己的代码进行检查。
##### **代码约定**
我们的代码风格几乎和标准 Java 约定一致（流行IDE的默认设置满足这一点），主要有以下附加限制：
* 如果当前行中有超过 120 个字符，则起一个新的行。
* 确保所有新的 .java 文件都有一个简单的 JavaDoc 类注释，最好至少有一个关于该类的解释说明。
* 将ASF许可注释添加到所有新的 .java 文件（从项目中的现有文件复制）
-* 请确保没有将 @author 标记添加到您所贡献的文件中，因为 Apache 不使用 @author 标记，其他方式（如cvs）将公平地记录所有您的贡献。
+* 请确保没有将 @author 标记添加到您所贡献的文件中，因为 Apache 不使用 @author 标记，其他方式（如
CVS、Git）将公平地记录所有您的贡献。
* 为代码添加一些 JavaDoc，如果您更改命名空间，则需要一些 XSD DOC 元素。
* 对于新的特征或重要的修复程序，应该添加单元测试。
* 如果没有其他人使用您的分支，请将它与 master（或主项目中的其他目标分支）同步。
@@ -130,4 +133,4 @@ Dubbo社区将会Review您的Pull Request，并可能提出修改意见，您可
### 参与发布投票
-参与发布投票是一种重要的贡献社区的方式，Dubbo
社区非常欢迎和鼓励任何人参与投票，每当一个版本需要正式发布的时候，会在开发者邮件列表上进行发布投票，只有当投票取得通过之后，才会正式发布，可以参考这个[检查列表](https://cwiki.apache.org/confluence/display/INCUBATOR/Incubator+Release+Checklist)对源码进行合规性检查。如果有任何问题，可以在开发者邮件列表上提问。
+参与发布投票是一种重要的贡献社区的方式，Dubbo
社区非常欢迎和鼓励任何人参与投票，每当一个版本需要正式发布的时候，会在开发者邮件列表上进行发布投票，只有当投票取得通过之后，才会正式发布，可以参考这个
[检查列表](https://cwiki.apache.org/confluence/display/INCUBATOR/Incubator+Release+Checklist)
对源码进行合规性检查。如果有任何问题，可以在开发者邮件列表上提问。
diff --git a/content/zh/docs3-v2/java-sdk/faq/1/9.md
b/content/zh/docs3-v2/java-sdk/faq/1/9.md
new file mode 100644
index 00000000000..b5410392258
--- /dev/null
+++ b/content/zh/docs3-v2/java-sdk/faq/1/9.md
@@ -0,0 +1,31 @@
+---
+type: docs
+title: "1-9 - 读写注册中心服务缓存失败"
+linkTitle: "1-9 - 读写注册中心服务缓存失败"
+weight: 9
+---
+
+## 可能的原因
+1. 多个 Dubbo 进程（或其他 Java 进程）使用了同一个缓存文件。
+2. 由于缓存文件所在目录的文件系统权限问题，导致读写失败。
+3. `dubbo.registry.file` 的值输入错误。
+4. 不小心指定了两个注册中心使用同一文件存储。
+
+{{% pageinfo %}}
+**提示：**
+
+如未指定 `dubbo.registry.file`，则注册中心服务缓存路径默认为 `~/.dubbo` 目录
+
+（其中 `~` 为用户的 HOME 目录）
+{{% /pageinfo %}}
+
+## 排查和解决步骤
+1. 检查 `dubbo.registry.file` 的值有无拼写错误。
+2. 检查是否有其它进程使用了同一份缓存文件。
+3. 如果指定了 `dubbo.registry.file`，那么检查下它在文件系统的权限。
+4. 排查是否出现了“两个注册中心使用了同一文件存储” 这一情况，如果出现则调整。
+
+## 另请参阅
+[注册中心的配置项参考手册](https://dubbo.apache.org/zh/docs3-v2/java-sdk/reference-manual/config/properties/#registry)
+
+<p style="margin-top: 3rem;"> </p>
\ No newline at end of file
