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://github.com/apache/dub…
Golang SDK 文档的欠缺打算将在稍后公布。
如何参加 Dubbo3 文档建设
- 依据个人兴趣、能力等状况在下方链接中找到想要参加的内容:
https://github.com/apache/dub… - 在对应 issue 下回复 assign,即可实现认领。
- 文档的编写将在该我的项目下进行:
https://github.com/apache/dub… - 仔细阅读:
https://github.com/apache/dub… - 在对应目录下撰写相干的文档:
https://github.com/apache/dub… - 提交文档内容相干的 PR 到 Master 分支,并在 Github 中发动 PR 时,填写要解决的相干的 issue。
注意事项:
- 认领 issue 前先确认是否是为无人认领的工作。
- 文档采纳 Markdown 语法进行撰写。即新建的文档文件应该为 xxx.md。
- 文档文件名称命名采纳英文。
- 但凡想参加文档撰写的小伙伴都能够退出钉钉群:44647297,申请内容为认领的 issue 链接 + Github ID。
阿里云首届中间件开发者大会举办在即,报名参会获取国内中间件开源采纳现状调研简报!
点击此处,立刻报名!