Dubbo 3.0 Documentation Task Force.

[chickenlj]

门面文档

目录	描述
什么是 Dubbo	Dubbo 简介（定义Dubbo、解决什么问题、秀重点功能）、核心概念（架构与概念串讲）、Dubbo 生态
快速开始	Golang 快速开始、Java 快速开始、Rust 快速开始
3.0 速览	Triple、应用级服务发现、IDL、云原生、Mesh、多语言
示例实践	以一个完整的 demo 完整的体验 Dubbo 特性，类似 istio tasks
用户手册	分语言建设的高级文档入口
FAQ	其他一些如 Benckmaking、兼容性等用户会关心的问题

Java SDK docs（v3.x）

• 简介（Introduction）（原文：https://dubbo.apache.org/zh/docs/introduction/，https://dubbo.apache.org/zh/docs/new-in-dubbo3/）
  • 用户（Users）
• 快速入门（Quick start）（提供两种方式，一种是正常的使用，另一种采用Maven插件，原文：https://dubbo.apache.org/zh/docs/references/maven/。quick start内涉及到的概念应该索引到对应文章，比如索引到RPC协议的文章）
  • 原文有：https://dubbo.apache.org/zh/docs/languages/java/
• 概念和架构（Concepts & Architecture）
  • 总体架构（原文：https://dubbo.apache.org/zh/docs/concepts/registry-configcenter-metadata/）
  • 服务发现（原文：https://dubbo.apache.org/zh/docs/concepts/service-discovery/）
  • 服务调用
  • 流量管理（https://dubbo.apache.org/zh/docs/references/routers）
    • https://dubbo.apache.org/zh/docs/examples/routing/
    • https://dubbo.apache.org/zh/docs/concepts/traffic-management/
    • https://dubbo.apache.org/zh/docs/advanced/routing-rule-deprecated/
    • https://dubbo.apache.org/zh/docs/advanced/routing-rule/
    • 路由规则
    • 集群容错
    • 负载均衡
• （突出的3.0特性）
• 高级特性和用法（Advanced Features & Usage）
  • 服务类特性
    • 发布多版本服务（原文：https://dubbo.apache.org/zh/docs/advanced/multi-versions/）
    • 服务分组（原文：https://dubbo.apache.org/zh/docs/advanced/service-group/）
    • 服务降级（原文：https://dubbo.apache.org/zh/docs/advanced/service-downgrade/）
  • 可观测性类特性
  • RPC请求类特性
    • 分组结果聚合（原文：https://dubbo.apache.org/zh/docs/advanced/group-merger/）
    • 参数校验（原文：https://dubbo.apache.org/zh/docs/advanced/parameter-validation/）
    • 异步调用（原文：https://dubbo.apache.org/zh/docs/advanced/async-call/，https://dubbo.apache.org/zh/docs/advanced/async-execute-on-provider/）
    • 泛化调用（原文：https://dubbo.apache.org/zh/docs/advanced/generic-service/，https://dubbo.apache.org/zh/docs/advanced/pb-generic-reference/，https://dubbo.apache.org/zh/docs/advanced/generic-reference/）
    • 调用链路传递隐式参数（原文：https://dubbo.apache.org/zh/docs/advanced/attachment/）
    • RPC调用上下文（原文：https://dubbo.apache.org/zh/docs/advanced/context/，需要细化）
    • 调用结果缓存（原文：https://dubbo.apache.org/zh/docs/advanced/result-cache/）
    • 调用触发事件通知（原文：https://dubbo.apache.org/zh/docs/advanced/events-notify/）
    • 服务端对客户端进行回调（原文：https://dubbo.apache.org/zh/docs/advanced/callback-parameter/）
    • 本地伪装（原文：https://dubbo.apache.org/zh/docs/advanced/local-mock/）
    • 本地存根（原文：https://dubbo.apache.org/zh/docs/advanced/local-stub/）
    • 回声测试（原文：https://dubbo.apache.org/zh/docs/advanced/echo-service/）
  • 安全类特性
    • TLS支持（原文：https://dubbo.apache.org/zh/docs/advanced/tls/）
    • 权限控制（原文：https://dubbo.apache.org/zh/docs/advanced/token-authorization/）
  • 性能优化类特性
    • 服务引用配置对象缓存（3.0中ReferenceConfigCache已经变更为ReferenceCache，文档需要重写，原文：https://dubbo.apache.org/zh/docs/advanced/reference-config-cache/）
    • 注册信息简化（原文：https://dubbo.apache.org/zh/docs/advanced/simplify-registry-data/）
    • 线程模型
      • 服务端线程池模型
      • 消费端线程池模型（原文：https://dubbo.apache.org/zh/docs/advanced/consumer-threadpool/）
  • 其他
    • 自定义服务容器（原文：https://dubbo.apache.org/zh/docs/advanced/service-container/）
    • 优雅停机（原文：https://dubbo.apache.org/zh/docs/advanced/graceful-shutdown/）
    • 主机地址自定义暴露（考虑迁移至配置项说明手册？原文：https://dubbo.apache.org/zh/docs/advanced/set-host/）
    • 访问日志记录（原文：https://dubbo.apache.org/zh/docs/advanced/accesslog/）
    • 日志框架适配（原文：https://dubbo.apache.org/zh/docs/advanced/logger-strategy/）
    • Kubernetes 生命周期探针（https://dubbo.apache.org/zh/docs/references/lifecycle/）
• 参考手册（Reference Manual）
  • 配置说明手册（原文：https://dubbo.apache.org/zh/docs/concepts/configuration/）
    • 配置概述（原文：https://dubbo.apache.org/zh/docs/references/configuration/overview/，主要介绍配置的方式，配置的优先级规则等）
    • XML 配置手册（原文：https://dubbo.apache.org/zh/docs/references/configuration/xml/，https://dubbo.apache.org/zh/docs/references/xml/）
      • 配置指南
      • 配置项说明
    • Annotation 配置手册（原文：https://dubbo.apache.org/zh/docs/references/configuration/annotation/）
    • API 配置手册（原文：https://dubbo.apache.org/zh/docs/references/api/，https://dubbo.apache.org/zh/docs/references/configuration/api/）
    • Properties 配置手册（原文：https://dubbo.apache.org/zh/docs/references/configuration/properties/）
    • Yaml 配置手册
    • 环境变量配置手册（原文：https://dubbo.apache.org/zh/docs/references/configuration/environment-variables/）
  • SPI扩展使用手册（原文：https://dubbo.apache.org/zh/docs/references/spis/，https://dubbo.apache.org/zh/docs/concepts/extensibility/）
    • Dubbo SPI概述
    • xxx扩展
  • QOS操作手册（原文：https://dubbo.apache.org/zh/docs/references/qos/ ，https://dubbo.apache.org/zh/docs/references/telnet/）
    • QOS概述（需要补充）
    • QOS命令手册（需要补充）
  • Dubbo 集成 Graalvm参考手册（原文：https://dubbo.apache.org/zh/docs/references/graalvm/support-graalvm/）
  • RPC协议参考手册（原文：https://dubbo.apache.org/zh/docs/concepts/rpc-protocol/，https://dubbo.apache.org/zh/docs/references/protocols/，剩余协议文档挪至《Dubbo Java SDK For SPI Extensions 》）
    • Dubbo协议
      • 概述
      • 使用说明
    • Triple协议
    • Rest协议（原文：https://dubbo.apache.org/zh/docs/references/lifecycle/rest/）
    • gRPC协议
  • 注册中心参考手册（原文：https://dubbo.apache.org/zh/docs/references/registry/，剩余注册中心扩展文档挪至《Dubbo Java SDK For SPI Extensions 》）
    • 注册中心概述
    • Nacos
    • Zookeeper
    • 广播
    • 多注册中心
  • 元数据中心参考手册（原文：https://dubbo.apache.org/zh/docs/references/metadata/）
  • 配置中心参考手册（原文：https://dubbo.apache.org/zh/docs/references/config-center/，https://dubbo.apache.org/zh/docs/references/configuration/external-config/）
  • 性能参考手册（原文：https://dubbo.apache.org/zh/docs/performance/benchmarking/）
• 升级和兼容性（Upgrades & Compatibility）（原文：https://dubbo.apache.org/zh/docs/migration/）
  • 2.x升级至3.x操作指南
  • Dubbo协议迁移至Triple协议指南
  • 接口级服务发现迁移至应用级服务发现指南
• 参与贡献（Contributing）
  • 概述（Overview）
  • 贡献指南（Contribution Guideline）

变更点注意

迁移到配置参考手册中介绍：

• 粘滞连接（原文：https://dubbo.apache.org/zh/docs/advanced/stickiness/）
• 延迟连接（原文：https://dubbo.apache.org/zh/docs/advanced/lazy-connect/）
• 连接控制（原文：https://dubbo.apache.org/zh/docs/advanced/config-connections/）
• 并发控制（原文：https://dubbo.apache.org/zh/docs/advanced/concurrency-control/）
• 延迟暴露（原文：https://dubbo.apache.org/zh/docs/advanced/delay-publish/）
• 本地调用（原文：https://dubbo.apache.org/zh/docs/advanced/local-call/）
• 静态服务（原文：https://dubbo.apache.org/zh/docs/advanced/static-service/）

废弃文档：

• https://dubbo.apache.org/zh/docs/advanced/protobuf-idl/（直接索引到Protobuf使用文档的链接）

迁移至Dubbo Admin的文档：

• https://dubbo.apache.org/zh/docs/advanced/config-rule/
• https://dubbo.apache.org/zh/docs/advanced/config-rule-deprecated/
• 路由规则配置：https://dubbo.apache.org/zh/docs/advanced/routing-rule-deprecated/、[https://dubbo.apache.org/zh/docs/advanced/routing-rule/](https://dubbo.apache.org/zh/docs/advanced/routing-rule/)

Golang SDK docs

Pixiu docs

Admin docs

[liubr1491]

上文中URL和右括号之间是否可以加个空格？