## Keyboard shortcuts

Press `←` or `→` to navigate between chapters

Press `S` or `/` to search in the book

Press `?` to show this help

Press `Esc` to hide this help

# 如何贡献

我们非常高兴您有兴趣为大道 (Dao OS) 做出贡献！作为一个社区驱动的项目，我们欢迎并珍视所有形式的贡献。本指南概述了您可以参与的方式以及提交贡献的流程。

## 我们的承诺与行为准则

为了营造一个开放、友善和包容的环境，我们承诺遵守一套行为准则。我们也期望所有贡献者和社区成员都能共同遵守。

（注：我们将正式采用 贡献者契约 (Contributor Covenant) 并在此处提供链接。）

## 贡献方式

您无需成为 Rust 专家才能做出贡献。有很多方式可以提供帮助：

- 核心开发: 为`元`库和核心协议（使用Rust）贡献代码。
- `道器`开发: 创建新的`道器`，它可以包含**`器`（UI）组件和`核`（无界面逻辑）组件**。
- 文档与翻译: 改进这些文档，撰写教程，以及将它们翻译成新的语言。
- 用户支持与社区管理: 帮助新用户，回答问题，营造一个热情、互助的氛围。
- 设计与用户体验: 为参考`道器`贡献UI/UX设计，并为生态定义设计模式。

## 你的第一个 Pull Request

我们对所有的代码贡献都采用标准的 GitHub Fork & Pull Request 工作流。

1. Fork 仓库: 创建目标仓库的一份你自己的拷贝（例如 `dao-os-docs`, `meta-unit`）。
2. 创建分支: 从 `main` 分支创建一个新的分支用于你的变更。请使用描述性的名称（例如 `feat/add-note-encryption`）。
3. 进行更改: 编写你的代码及相应的测试。
4. 运行本地检查: 在提交前，请确保你运行了所有本地测试和代码格式化工具。
5. Commit 你的变更: 我们鼓励使用 Conventional Commits 规范，以获得清晰可读的 commit 消息。
6. Push到你的Fork: 将你的变更推送到你自己的 Fork 仓库。
7. 开启一个 Pull Request: 从你的分支向 Dao OS 官方仓库的 `main` 分支提交一个 Pull Request (PR)。
8. 描述你的 PR: 在 PR 的描述中，请链接任何相关的 issue，并清晰地描述你正在解决的问题和你的解决方案。
9. 等待审查: 一位核心团队成员将会审查你的 PR，提供反馈，并在就绪后将其合并。

## 配置你的开发环境

（此部分将在每个仓库中被详细填写。）

要为 `meta-unit` 做出贡献，您通常需要：

- Rust 工具链 (`rustup`)
- WebAssembly 构建目标 (`wasm32-wasi`)
- Protocol Buffers 编译器 (`protoc`)

请参考每个具体仓库中的 `README.md` 以获取详细的配置指南。

## 还有问题？

如果您有任何疑问，请随时在我们官方的沟通渠道中提问。我们很乐意帮助您开始！