## Dubbo 官網文件寫手召集令

Dubbo3 是 Dubbo 新的里程碑，Dubbo 的生態元件（包括 Dubbo Java SDK，Dubbo Golang SDK 等）都在向 Dubbo3 的目標靠攏，在使用者實踐方面，包括阿里巴巴、淘寶、天貓、餓了麼、工商銀行、平安健康等企業都已成功升級 Dubbo3 版本，隨著更多的企業和使用者關注或升級 Dubbo3，整個社群對 Dubbo3 的文件的需求開始變得更加迫切，以幫助使用者正確使用 Dubbo3 功能或知道如何排查遇到的問題。

官網的文件目前主要面臨兩個問題：文件內容相對滯後、文件結構不夠清晰，為了提高 Dubbo 官網文件的質量，讓 Dubbo 官網的文件能夠幫助到更多的使用者，Dubbo 社群藉著 Dubbo3 這一里程碑，對 Dubbo 官網的文件結構進行了全面升級，集火解決以上兩個痛點。 在文件建設和升級的過程中，Dubbo 社群也希望能召集一些小夥伴一起參與進來。並拆分了一些文件任務給社群的小夥伴進行認領。

參與貢獻的小夥伴能夠透過撰寫文件全面的瞭解 Dubbo 的特性，並且根據貢獻者的貢獻度排名，會得到相應的獎品，比如限量版 Dubbo 社群周邊T恤、水杯等。除此之外活躍的貢獻者有機會被提名為 Apache Dubbo Committer。

## 關於 Dubbo3 全新文件結構

為了滿足不同使用者的需求，Dubbo 社群對文件的結構做了升級，全新的文件分為 “門面文件“  和 “高階文件” 兩部分。

### 入門文件

門面文件主要從 Dubbo 生態整體的視角來介紹 Dubbo，除了介紹 Dubbo 生態以外，它也包括索引到各個生態元件高階文件的能力，主要用於幫助使用者能快速瞭解 Dubbo，並從中找到自己所需的內容。具體的文件結構如下：

-   什麼是 Dubbo：包含 Dubbo 的簡介（定義 Dubbo、解決什麼問題、秀重點功能）、核心概念（架構與概念串講）、Dubbo 生態。
-   快速開始：包含 Golang 快速開始、Java 快速開始、Rust 快速開始等內容。
-   3.0 速覽：包含 Triple、應用級服務發現、IDL、雲原生、Mesh、多語言等新特性的簡述。
-   示例實踐：包含以一個完整的 demo 完整的體驗 Dubbo 特性的實踐示例。
-   使用者手冊：分語言建設的高階文件入口。
-   FAQ：其他一些如 Benckmaking、相容性等使用者會關心的問題

### 高階文件（語言相關）

Dubbo 從 Java SDK 起家，到現在已經有 Golang SDK 、生態也越來越龐大，高階文件則是對 Dubbo 生態元件的內容進行細緻的描述，包含了所有使用者想要關係的細節。所有生態元件的文件頂層結構都是一致的，具體的結構如下：

-   簡介
-   快速入門
-   概念和架構
-   高階特性和用法
-   參考手冊
-   升級和相容性
-   參與貢獻

各類元件的高階文件都正在建設中，其中 Java SDK 的詳細目錄已經確定，詳情見：

<https:>

Golang SDK 文件的完善計劃將在稍後釋出。

## 如何參與 Dubbo3 文件建設

1.  根據個人興趣、能力等情況在下方連結中找到想要參與的內容：
    <https:>

1.  在對應 issue 下回復 assign，即可完成認領。

1.  文件的編寫將在該專案下進行：
    <https:>

1.  仔細閱讀：
    <https:>

1.  在對應目錄下撰寫相關的文件：
    <https:>

1.  提交文件內容相關的 PR 到 Master 分支，並在 Github 中發起 PR 時，填寫要解決的相關的 issue。

注意事項：

1.  認領 issue 前先確認是否是為無人認領的任務。
1.  文件採用 Markdown 語法進行撰寫。即新建的文件檔案應該為 xxx.md。
1.  文件檔名稱命名採用英文。
1.  凡是想參與文件撰寫的小夥伴都可以加入釘釘群：44647297，申請內容為認領的 issue 連結 + Github ID。

***

**阿里雲首屆中介軟體開發者大會舉辦在即，報名參會獲取國內中介軟體開源採用現狀調研簡報！**

![1.png](https://p3-juejin.byteimg.com/tos-cn-i-k3u1fbpfcp/0f76ec9d39654dec85062ab5e138f1e9~tplv-k3u1fbpfcp-zoom-1.image "1.png")

點選[此處](https://developer.aliyun.com/topic/middleware/developer/summit)，立即報名！</https:></https:></https:></https:></https:>

Dubbo3 官方文件貢獻者徵集令

相關文章