加入Fedora文档贡献者行列实用指南带你了解写作标准协作工具与社区沟通技巧成为开源一员

威震华夏关云长

引言

Fedora作为全球领先的开源操作系统之一，其成功离不开活跃的社区贡献和完善的文档体系。文档是连接用户与软件的桥梁，优质的文档能够显著提升用户体验，降低使用门槛，促进项目的可持续发展。加入Fedora文档贡献者行列不仅是对开源社区的支持，也是提升个人技术写作能力、协作能力和专业素养的绝佳机会。

本文将全面介绍如何成为Fedora文档贡献者，从写作标准、协作工具到社区沟通技巧，帮助你顺利融入这个充满活力的开源社区，成为一名合格的文档贡献者。

Fedora文档项目概述

Fedora文档项目的历史与使命

Fedora文档项目始于Fedora项目成立之初，旨在为用户提供全面、准确、及时的操作指南和技术文档。其使命是通过协作创建高质量的自由文档，赋能用户，促进知识共享，支持Fedora生态系统的发展。

文档类型和结构

Fedora文档主要分为以下几类：

1. 安装指南：帮助用户完成Fedora系统的安装过程
2. 用户指南：面向普通用户的日常操作指南
3. 系统管理员指南：针对系统管理员的进阶内容
4. 发行说明：每个Fedora版本的新功能和变更说明
5. 安全指南：系统安全配置和最佳实践
6. 特定技术文档：如SELinux、虚拟化等专项技术文档

这些文档通常采用模块化结构，便于维护和更新，同时确保内容的一致性和连贯性。

文档维护团队介绍

Fedora文档团队由全球各地的志愿者组成，包括：

• 文档团队负责人：协调团队工作，制定发展方向
• 编辑：负责内容审核和质量控制
• 作者：撰写和更新文档内容
• 翻译：将文档翻译成多种语言
• 发布协调员：管理文档发布流程

团队成员通过邮件列表、IRC频道和定期会议保持沟通，共同推进文档项目的发展。

贡献者的角色和责任

作为Fedora文档贡献者，你可以根据自身兴趣和技能选择不同的角色：

• 内容贡献者：撰写新内容，更新现有文档
• 技术审阅者：检查技术准确性
• 语言编辑：改进语言表达和可读性
• 翻译贡献者：将文档翻译成其他语言
• 工具开发者：改进文档构建工具和流程

无论选择哪种角色，都需要遵守社区准则，尊重他人贡献，保持开放和协作的态度。

写作标准与规范

Fedora文档风格指南

Fedora文档遵循统一的风格指南，确保所有文档在语言、格式和结构上保持一致。以下是关键的风格要点：

1. 语言简洁明了：使用简单直接的语言，避免冗长复杂的句子
2. 术语一致性：使用Fedora官方术语，避免同义词混用
3. 主动语态：优先使用主动语态，使文档更加直接和有力
4. 第二人称：直接与读者对话，使用”你”而非”用户”
5. 性别中立：使用性别中立的语言，避免性别假设

例如，不推荐：

2. 用户应该点击"下一步"按钮来继续安装过程。

复制代码

推荐：

2. 点击"下一步"按钮继续安装。

复制代码

文档结构和格式要求

Fedora文档采用标准化的结构，便于读者理解和维护：

1. 标题层级：使用清晰的标题层级，通常不超过4级
2. 章节组织：相关内容组织在一起，逻辑流程清晰
3. 步骤说明：操作步骤使用编号列表，每个步骤以动词开头
4. 代码示例：代码块使用语法高亮，附带解释说明
5. 注意事项：重要信息使用提示框或警告框突出显示

AsciiDoc是Fedora文档的标准格式，以下是一个简单的AsciiDoc示例：

2. = 文档标题
4. == 章节标题
6. === 子章节标题
8. 这是一个段落。你可以使用*粗体*、_斜体_和`等宽字体`来强调文本。
10. .有序列表项
11. .另一个有序列表项
13. * 无序列表项
14. * 另一个无序列表项
16. [source,bash]
17. ----
18. 命令示例
19. ----
21. NOTE: 这是一个提示框。
23. WARNING: 这是一个警告框。

复制代码

语言和术语使用规范

Fedora文档对语言和术语使用有严格要求：

1. 美式英语：使用美式英语拼写和语法
2. 技术术语：首次出现时提供简短解释
3. 产品名称：Fedora产品名称使用正确的大小写，如”Fedora Workstation”
4. 避免行话：除非必要，否则避免使用行业行话
5. 一致性：同一概念在整个文档中使用相同术语

例如，不推荐：

2. The Fedora OS allows you to customise your desktop environment.

复制代码

推荐：

2. Fedora allows you to customize your desktop environment.

复制代码

示例和最佳实践

以下是一些文档写作的最佳实践示例：

1. 任务导向的写作：
“`asciidoc
== Installing Fedora

To install Fedora:

. Download the latest Fedora image from thehttps://fedoraproject.org/[Fedorawebsite].
   . Create a bootable media using a USB drive or DVD.
   . Boot from the media and follow the installation wizard.

2. 2. **清晰的命令示例**：
3.    ```asciidoc
4.    [source,bash]
5.    ----
6.    # Update your system
7.    sudo dnf update
8.    
9.    # Install a package
10.    sudo dnf install package-name
11.    ----

复制代码

1. 有效的交叉引用：For more information about system administration, see xref:admin-guide.adoc[System Administrator's Guide].
2.

2. 适当的警告和提示：
3. “`asciidoc
4. NOTE: Back up your data before performing system updates.

复制代码

有效的交叉引用：

2. For more information about system administration, see xref:admin-guide.adoc[System Administrator's Guide].

复制代码

适当的警告和提示：
“`asciidoc
NOTE: Back up your data before performing system updates.

WARNING: Incorrectly editing system configuration files may cause system instability.

2. 通过遵循这些标准和规范，你可以确保文档内容的一致性和专业性，提升用户体验。
4. ## 协作工具使用指南
6. ### 版本控制系统（Git）基础
8. Git是Fedora文档项目使用的版本控制系统，掌握Git基础是成为文档贡献者的必要技能。
10. #### Git基本概念
12. - **仓库（Repository）**：存储项目文件和版本历史的地方
13. - **提交（Commit）**：保存项目状态的快照
14. - **分支（Branch）**：独立的开发线，便于并行工作
15. - **合并（Merge）**：将一个分支的更改整合到另一个分支
17. #### Git基本操作
19. 以下是一些常用的Git命令：
21. ```bash
22. # 克隆仓库
23. git clone https://pagure.io/fedora-docs/docs.git
25. # 查看状态
26. git status
28. # 添加文件到暂存区
29. git add filename.adoc
31. # 提交更改
32. git commit -m "描述你的更改"
34. # 推送到远程仓库
35. git push origin branch-name
37. # 拉取最新更改
38. git pull
40. # 创建新分支
41. git checkout -b new-branch-name
43. # 切换分支
44. git checkout branch-name

复制代码

Fedora文档项目使用以下Git工作流程：

1. Fork主仓库：在Pagure上Fork官方文档仓库
2. 克隆本地副本：将你的Fork克隆到本地
3. 创建功能分支：为每个任务创建独立分支
4. 进行更改：编辑文档，提交更改
5. 推送更改：将分支推送到你的Fork
6. 创建合并请求：在Pagure上提交合并请求

Pagure介绍和使用

Pagure是Fedora项目使用的基于Git的协作平台，类似于GitHub但具有更多针对Fedora项目的定制功能。

1. 访问https://pagure.io/并注册账户
2. 配置SSH密钥以便安全访问：
“`bash生成SSH密钥（如果尚未生成）ssh-keygen -t rsa -b 4096

访问https://pagure.io/并注册账户

配置SSH密钥以便安全访问：
“`bash

ssh-keygen -t rsa -b 4096

# 查看公钥
   cat ~/.ssh/id_rsa.pub

2. 3. 将公钥添加到Pagure账户设置中
4. #### 使用Pagure进行协作
6. 1. **Fork仓库**：
7.    - 打开你想要贡献的文档仓库页面
8.    - 点击"Fork"按钮
9.    - 选择你的命名空间
11. 2. **创建合并请求（Merge Request）**：
12.    - 在你的Fork中，点击"Pull Requests"标签
13.    - 点击"New Pull Request"
14.    - 选择源分支和目标分支
15.    - 提供清晰的标题和描述
16.    - 提交合并请求
18. 3. **管理合并请求**：
19.    - 查看评论和反馈
20.    - 根据需要更新你的分支
21.    - 与维护者沟通解决问题
23. ### AsciiDoc写作工具
25. AsciiDoc是Fedora文档的标准格式，掌握相关工具能提高写作效率。
27. #### 文本编辑器
29. 推荐支持AsciiDoc的文本编辑器：
31. 1. **Visual Studio Code**：
32.    - 安装"AsciiDoc"扩展
33.    - 提供语法高亮、预览和验证功能
35. 2. **Vim**：
36.    ```vim
37.    " 安装vim-asciidoc插件
38.    Plug 'asciidoc/vim-asciidoc'

复制代码

1.

2. Emacs：;; 安装adoc-mode
3. (package-install 'adoc-mode)

复制代码

2. ;; 安装adoc-mode
3. (package-install 'adoc-mode)

复制代码

以下是一些常用的AsciiDoc语法：

2. = 文档标题
4. Author Name <email@example.com>
6. :toc: left
7. :toclevels: 4
8. :icons: font
10. == 章节标题
12. === 子章节标题
14. 这是一个段落。你可以使用*粗体*、_斜体_和`等宽字体`。
16. .有序列表项
17. .另一个有序列表项
19. * 无序列表项
20. * 另一个无序列表项
22. [source,bash]
23. ----
24. 命令示例
25. ----
27. |===
28. | 表头1 | 表头2
29. | 单元格1 | 单元格2
30. | 单元格3 | 单元格4
31. |===
33. NOTE: 这是一个提示。
35. WARNING: 这是一个警告.
37. CAUTION: 这是一个注意.

复制代码

本地构建和预览文档

在提交更改前，本地构建和预览文档可以确保格式正确，内容无误。

2. # 安装必要的软件包
3. sudo dnf install asciidoc python3-pip
5. # 安装Fedora文档构建工具
6. pip install-fedora-docs

复制代码

2. # 克隆仓库
3. git clone https://pagure.io/fedora-docs/docs.git
4. cd docs
6. # 构建所有文档
7. antora --cache-dir=.cache/antora playbook.yml
9. # 构建特定语言
10. antora --cache-dir=.cache/antora --fetch playbook.yml

复制代码

构建后的HTML文件位于public目录中，你可以使用Web服务器预览：

2. # 使用Python内置HTTP服务器
3. cd public
4. python3 -m http.server 8080

复制代码

然后在浏览器中访问http://localhost:8080查看文档。

其他辅助工具

除了上述核心工具外，以下辅助工具也能提高你的工作效率：

1. 文本校对工具：
“`bash安装proselintpip install proselint

文本校对工具：
“`bash

pip install proselint

# 检查文档
   proselint filename.adoc

2. 2. **拼写检查**：
3.    ```bash
4.    # 安装aspell
5.    sudo dnf install aspell aspell-en
6.    
7.    # 检查拼写
8.    aspell --lang=en_US check filename.adoc

复制代码

1. 链接检查：
“`bash安装linkcheckersudo dnf install linkchecker

链接检查：
“`bash

sudo dnf install linkchecker

# 检查链接
   linkcheckerhttp://localhost:8080

2. 通过熟练使用这些协作工具，你可以高效地参与Fedora文档项目，与社区成员无缝协作，共同创建高质量的文档。
4. ## 社区沟通技巧
6. ### 邮件列表使用指南
8. 邮件列表是Fedora文档社区的主要沟通渠道之一，有效使用邮件列表对于融入社区至关重要。
10. #### 主要邮件列表
12. 1. **docs@lists.fedoraproject.org**：文档项目的主要讨论列表
13. 2. **trans@lists.fedoraproject.org**：翻译相关讨论
14. 3. **devel@lists.fedoraproject.org**：Fedora开发讨论（文档相关公告）
16. #### 订阅邮件列表
18. 1. 访问 https://lists.fedoraproject.org/
19. 2. 搜索并选择你感兴趣的列表
20. 3. 点击"Subscribe"并按照指示完成订阅
22. #### 邮件列表礼仪
24. 1. **明确的主题**：使用描述性主题行，便于归档和搜索
25.    - 好："[PATCH] Fix broken links in Installation Guide"
26.    - 不好："Documentation issue"
28. 2. **简洁的回复**：回复时只保留必要的上下文，删除无关内容
30. 3. **适当的签名**：包含你的姓名和联系信息

复制代码

–
   Your Namehttps://fedoraproject.org/wiki/User:YourUsername

2. 4. **避免HTML邮件**：使用纯文本格式，确保兼容性
4. 5. **耐心等待**：社区成员分布在全球各地，可能需要时间回应
6. #### 有效提问技巧
8. 在邮件列表中提问时，遵循以下原则可以提高获得有用回应的几率：
10. 1. **做足功课**：提问前先搜索文档和邮件列表存档
12. 2. **提供上下文**：

复制代码

我正在尝试更新Fedora 35安装指南中的分区说明（第4.2节）。
   我注意到当前描述与实际安装程序界面不符。

我已经查看了：

• 当前的文档版本：https://docs.fedoraproject.org/en-US/fedora/f35/install-guide/install/Installing_Using_Anaconda/
• 相关的BZ：#123456

我的问题是：是否应该更新文档以反映新的界面，还是应该报告这是一个回归？

2. 3. **明确你的需求**：具体说明你需要的帮助类型
4. ### IRC/Matrix聊天室礼仪
6. 实时聊天平台如IRC和Matrix是快速交流和获取帮助的有效方式。
8. #### 主要聊天室
10. 1. **#fedora-docs**：文档项目讨论（irc.libera.chat或Matrix）
11. 2. **#fedora**：一般Fedora讨论
12. 3. **#fedora-l10n**：本地化和翻译讨论
14. #### 连接方式
16. **IRC客户端**：
17. ```bash
18. # 使用HexChat（图形界面）
19. sudo dnf install hexchat
21. # 使用irssi（命令行）
22. sudo dnf install irssi
23. irssi
24. /connect irc.libera.chat
25. /join #fedora-docs

复制代码

Matrix客户端：

2. # 使用Element（图形界面）
3. sudo dnf install element-desktop
5. # 使用Fractal（GNOME应用）
6. sudo dnf install fractal

复制代码

1. 耐心等待：提问后等待回应，不要立即重复
2. 简洁明了：好：”有人能帮我理解文档仓库的分支策略吗？”不好：”有人吗？我有个问题…”
3. 好：”有人能帮我理解文档仓库的分支策略吗？”
4. 不好：”有人吗？我有个问题…”
5. 使用pastebin：分享长文本或代码时使用pastebin服务我遇到了一个构建错误，详细信息：https://paste.fedoraproject.org/paste/123456
6. 尊重时区：记住社区成员分布在不同时区
7. 避免洪水：不要发送大量连续消息

耐心等待：提问后等待回应，不要立即重复

简洁明了：

• 好：”有人能帮我理解文档仓库的分支策略吗？”
• 不好：”有人吗？我有个问题…”

使用pastebin：分享长文本或代码时使用pastebin服务

2. 我遇到了一个构建错误，详细信息：https://paste.fedoraproject.org/paste/123456

复制代码

尊重时区：记住社区成员分布在不同时区

避免洪水：不要发送大量连续消息

1. 自我介绍：首次加入时简单介绍自己大家好，我是John，刚加入Fedora文档项目。我对更新安装指南感兴趣。
2. 关注讨论：先观察几天，了解社区动态和讨论风格
3. 提供帮助：即使你是新手，也可以尝试回答你知道的问题
4. 记录重要决定：将聊天中的重要讨论和决定记录到邮件列表或文档中

自我介绍：首次加入时简单介绍自己

2. 大家好，我是John，刚加入Fedora文档项目。我对更新安装指南感兴趣。

复制代码

关注讨论：先观察几天，了解社区动态和讨论风格

提供帮助：即使你是新手，也可以尝试回答你知道的问题

记录重要决定：将聊天中的重要讨论和决定记录到邮件列表或文档中

问题跟踪系统使用

问题跟踪系统是管理文档改进、错误报告和功能请求的重要工具。

Fedora使用Bugzilla作为问题跟踪系统：

1. 访问Bugzilla：https://bugzilla.redhat.com/
2. 创建账户：使用FAS（Fedora Account System）凭据登录
3. 搜索现有报告：提交新报告前先搜索是否已存在类似问题

访问Bugzilla：https://bugzilla.redhat.com/

创建账户：使用FAS（Fedora Account System）凭据登录

搜索现有报告：提交新报告前先搜索是否已存在类似问题

创建文档Bug报告时，提供以下信息：

1. 清晰的标题：好：”Installation Guide: Section 3.1 contains outdated package names”不好：”Documentation error”
2. 好：”Installation Guide: Section 3.1 contains outdated package names”
3. 不好：”Documentation error”
4. 详细描述：
“`
在Fedora 35安装指南的第3.1节”软件选择”中，列出的软件包名称已过时。

清晰的标题：

• 好：”Installation Guide: Section 3.1 contains outdated package names”
• 不好：”Documentation error”

详细描述：
“`
在Fedora 35安装指南的第3.1节”软件选择”中，列出的软件包名称已过时。

具体位置：https://docs.fedoraproject.org/en-US/fedora/f35/install-guide/install/Installing_Using_Anaconda/#sect-software-selection

问题：
   文档中提到的”libreoffice-writer”包在当前仓库中已不存在，正确的包名是”libreoffice-writer-core”。

影响：
   用户可能无法按照文档说明找到正确的软件包。

2. 3. **附加信息**：
3.    - 截图（如果适用）
4.    - 错误消息
5.    - 相关链接
7. 4. **建议的修复**（如果可能）：

复制代码

建议将文档中的”libreoffice-writer”更新为”libreoffice-writer-core”。

2. #### 参与Bug处理
4. 1. **认领Bug**：如果你计划修复某个Bug，在评论中表明

复制代码

我将处理这个Bug，准备提交一个修复补丁。

2. 2. **提供信息**：如果你能提供额外信息，帮助解决问题
4. 3. **测试修复**：测试已修复的Bug并确认是否解决
6. ### 参与会议和讨论
8. 定期会议是Fedora文档社区协调工作、讨论进展的重要方式。
10. #### 文档团队会议
12. 1. **时间**：通常每两周一次，具体时间在邮件列表中公告
14. 2. **参与方式**：
15.    - 通过BlueJeans或Jitsi视频会议
16.    - IRC/Matrix聊天室（#fedora-meeting）
18. 3. **会议议程**：
19.    - 提前在邮件列表中发布
20.    - 可以在会议前添加议题
22. #### 有效参与会议
24. 1. **提前准备**：阅读议程和相关材料
26. 2. **准时参加**：尊重他人时间
28. 3. **简洁发言**：
29.    - 清晰表达观点
30.    - 避免打断他人
31.    - 相关时发言，避免偏离主题
33. 4. **会后跟进**：
34.    - 查看会议纪要
35.    - 完成分配的任务
36.    - 提供反馈
38. #### 异步讨论
40. 对于无法参加实时会议的情况，可以通过以下方式参与讨论：
42. 1. **邮件列表**：在会议前通过邮件提供意见
44. 2. **Pagure问题**：在相关问题上评论
46. 3. **文档Wiki**：编辑和评论提案页面
48. ### 跨文化沟通注意事项
50. Fedora是一个全球性社区，跨文化沟通能力对于有效协作至关重要。
52. #### 语言和文化差异
54. 1. **使用简单英语**：
55.    - 避免俚语和习语
56.    - 使用简单直接的句子
57.    - 解释技术术语
59. 2. **注意时区**：
60.    - 提及时间时注明时区（如14:00 UTC）
61.    - 考虑其他地区成员的工作时间
63. 3. **尊重文化差异**：
64.    - 避免假设宗教或政治观点
65.    - 注意不同文化中的礼仪差异
67. #### 有效沟通策略
69. 1. **明确表达**：
70.    - 清晰陈述你的观点和需求
71.    - 避免模糊表述
73. 2. **积极倾听**：
74.    - 认真阅读和理解他人观点
75.    - 提问确认理解
77. 3. **建设性反馈**：
78.    - 关注问题而非个人
79.    - 提供具体改进建议
80.    - 认可他人的贡献
82. 4. **解决冲突**：
83.    - 保持冷静和专业
84.    - 寻求共同点
85.    - 必要时寻求调解
87. 通过掌握这些社区沟通技巧，你可以更有效地融入Fedora文档社区，与其他贡献者建立良好的合作关系，共同推动文档项目的发展。
89. ## 贡献流程详解
91. ### 注册Fedora账户
93. 成为Fedora文档贡献者的第一步是创建Fedora账户系统（FAS）账户。
95. #### 创建FAS账户
97. 1. 访问 https://accounts.fedoraproject.org/
98. 2. 点击"Sign up"按钮
99. 3. 填写必要信息：
100.    - 用户名（将成为你的社区身份标识）
101.    - 电子邮件地址
102.    - 密码
103. 4. 同意行为准则和条款
104. 5. 提交注册表单
106. #### 完成账户设置
108. 1. **验证电子邮件**：
109.    - 检查收件箱中的验证邮件
110.    - 点击验证链接
112. 2. **签署CLA（Contributor License Agreement）**：
113.    - 登录FAS账户
114.    - 导航到"Agreements"部分
115.    - 签署Fedora Project Contributor Agreement
117. 3. **配置SSH密钥**（可选但推荐）：
118.    ```bash
119.    # 生成SSH密钥对
120.    ssh-keygen -t ed25519 -C "your_email@example.com"
121.    
122.    # 查看公钥
123.    cat ~/.ssh/id_ed25519.pub

复制代码

• 将公钥添加到FAS账户的”Keys”部分

1. 加入邮件列表：访问https://lists.fedoraproject.org/订阅docs@lists.fedoraproject.org
2. 访问https://lists.fedoraproject.org/
3. 订阅docs@lists.fedoraproject.org

• 访问https://lists.fedoraproject.org/
• 订阅docs@lists.fedoraproject.org

设置开发环境

配置适当的开发环境可以显著提高你的贡献效率。

2. # 安装Git
3. sudo dnf install git
5. # 配置Git用户信息
6. git config --global user.name "Your Name"
7. git config --global user.email "your_email@example.com"
9. # 安装文本编辑器（以VS Code为例）
10. sudo dnf install code
12. # 安装AsciiDoc工具
13. sudo dnf install asciidoc
15. # 安装Antora（文档构建工具）
16. sudo dnf install antora
18. # 安装其他有用工具
19. sudo dnf install enchant hunspell-en-US proselint linkchecker

复制代码

1. 配置SSH访问：
“`bash测试SSH连接ssh -T git@pagure.io

配置SSH访问：
“`bash

ssh -T git@pagure.io

# 如果成功，你将看到类似以下消息：
   # PTY allocation request failed on channel 0
   # Hi your-username! You’ve successfully authenticated…

2. 2. **配置Git使用FAS凭据**：
3.    ```bash
4.    # 安装git-fedora
5.    sudo dnf install git-fedora
6.    
7.    # 配置Git使用FAS
8.    git config --global credential.helper fedora

复制代码

2. # 创建工作目录
3. mkdir -p ~/fedora-docs
4. cd ~/fedora-docs
6. # 克隆你感兴趣的文档仓库
7. git clone git@pagure.io:fedora-docs/docs.git
8. cd docs

复制代码

查找和选择贡献任务

找到适合你技能和兴趣的贡献任务是成功参与的关键。

1. 文档团队看板：访问https://pagure.io/fedora-docs/docs/issues查看标记为”good first issue”或”help wanted”的问题
2. 访问https://pagure.io/fedora-docs/docs/issues
3. 查看标记为”good first issue”或”help wanted”的问题
4. 邮件列表：关注docs@lists.fedoraproject.org寻找请求帮助的邮件
5. 关注docs@lists.fedoraproject.org
6. 寻找请求帮助的邮件
7. 社区会议：参加文档团队会议了解当前优先事项和需要帮助的任务
8. 参加文档团队会议
9. 了解当前优先事项和需要帮助的任务
10. 文档Wiki：访问https://fedoraproject.org/wiki/Docs_Project查看维护的文档列表和状态
11. 访问https://fedoraproject.org/wiki/Docs_Project
12. 查看维护的文档列表和状态

文档团队看板：

• 访问https://pagure.io/fedora-docs/docs/issues
• 查看标记为”good first issue”或”help wanted”的问题

邮件列表：

• 关注docs@lists.fedoraproject.org
• 寻找请求帮助的邮件

社区会议：

• 参加文档团队会议
• 了解当前优先事项和需要帮助的任务

文档Wiki：

• 访问https://fedoraproject.org/wiki/Docs_Project
• 查看维护的文档列表和状态

1. 初学者友好任务：修复拼写和语法错误更新过时的链接改进文档结构添加缺失的步骤说明
2. 修复拼写和语法错误
3. 更新过时的链接
4. 改进文档结构
5. 添加缺失的步骤说明
6. 中级任务：更新文档以反映软件变更添加新功能说明改进示例和截图翻译文档到其他语言
7. 更新文档以反映软件变更
8. 添加新功能说明
9. 改进示例和截图
10. 翻译文档到其他语言
11. 高级任务：创建全新文档重构大型文档改进文档构建系统开发文档工具
12. 创建全新文档
13. 重构大型文档
14. 改进文档构建系统
15. 开发文档工具

初学者友好任务：

• 修复拼写和语法错误
• 更新过时的链接
• 改进文档结构
• 添加缺失的步骤说明

中级任务：

• 更新文档以反映软件变更
• 添加新功能说明
• 改进示例和截图
• 翻译文档到其他语言

高级任务：

• 创建全新文档
• 重构大型文档
• 改进文档构建系统
• 开发文档工具

1. 在Bugzilla中认领：评论相关Bug报告表明你计划处理这个问题例如：”我将处理这个Bug，准备提交一个修复补丁。”
2. 评论相关Bug报告
3. 表明你计划处理这个问题
4. 例如：”我将处理这个Bug，准备提交一个修复补丁。”
5. 在Pagure中分配：如果你有权限，可以将问题分配给自己否则，在评论中请求分配
6. 如果你有权限，可以将问题分配给自己
7. 否则，在评论中请求分配

在Bugzilla中认领：

• 评论相关Bug报告
• 表明你计划处理这个问题
• 例如：”我将处理这个Bug，准备提交一个修复补丁。”

在Pagure中分配：

• 如果你有权限，可以将问题分配给自己
• 否则，在评论中请求分配

提交更改的步骤

掌握正确的提交流程是成为有效贡献者的关键。

1. 同步最新代码：git checkout main
git pull upstream main
2. 创建功能分支：git checkout -b fix-typos-in-install-guide
3. 进行更改：编辑文档文件遵循AsciiDoc格式规范确保更改符合项目风格指南
4. 编辑文档文件
5. 遵循AsciiDoc格式规范
6. 确保更改符合项目风格指南
7. 构建和预览：
“`bash本地构建文档antora –cache-dir=.cache/antora playbook.yml

同步最新代码：

2. git checkout main
3. git pull upstream main

复制代码

创建功能分支：

2. git checkout -b fix-typos-in-install-guide

复制代码

进行更改：

• 编辑文档文件
• 遵循AsciiDoc格式规范
• 确保更改符合项目风格指南

构建和预览：
“`bash

antora –cache-dir=.cache/antora playbook.yml

# 启动本地服务器预览
   cd public
   python3 -m http.server 8080

2. - 在浏览器中检查更改效果
3.    - 确保格式正确，链接有效
5. 5. **提交更改**：
6.    ```bash
7.    # 添加更改的文件
8.    git add path/to/changed/file.adoc
9.    
10.    # 提交更改
11.    git commit -m "Fix typos in Installation Guide section 3.2"

复制代码

1. 推送分支：git push origin fix-typos-in-install-guide

2. git push origin fix-typos-in-install-guide

复制代码

1. 访问Pagure：打开你的Fork页面点击”Pull Requests”标签点击”New Pull Request”
2. 打开你的Fork页面
3. 点击”Pull Requests”标签
4. 点击”New Pull Request”
5. 填写合并请求信息：标题：简洁描述更改描述：详细说明更改内容和原因关联问题：链接到相关的Bugzilla或Pagure问题
6. 标题：简洁描述更改
7. 描述：详细说明更改内容和原因
8. 关联问题：链接到相关的Bugzilla或Pagure问题
9. 示例合并请求描述：
“`
This PR fixes typos in the Installation Guide section 3.2.

访问Pagure：

• 打开你的Fork页面
• 点击”Pull Requests”标签
• 点击”New Pull Request”

填写合并请求信息：

• 标题：简洁描述更改
• 描述：详细说明更改内容和原因
• 关联问题：链接到相关的Bugzilla或Pagure问题

示例合并请求描述：
“`
This PR fixes typos in the Installation Guide section 3.2.

Changes:

• Corrected spelling of “configuration” (was “configuation”)
• Fixed grammatical errors in step 4
• Updated broken link to repository page

Fixes: #12345

Testing:

• Built locally with Antora
• Checked all links work correctly
• Verified formatting is consistent
“`

1. 查看评论：定期检查合并请求的评论及时回应维护者的反馈
2. 定期检查合并请求的评论
3. 及时回应维护者的反馈
4. 更新更改：
“`bash切换到你的分支git checkout fix-typos-in-install-guide

查看评论：

• 定期检查合并请求的评论
• 及时回应维护者的反馈

更新更改：
“`bash

git checkout fix-typos-in-install-guide

# 进行必要的更改
   # …

# 提交更改
   git add .
   git commit -m “Address reviewer feedback: fix additional typos”

# 推送更新
   git push origin fix-typos-in-install-guide

2. 3. **持续沟通**：
3.    - 保持开放和积极的态度
4.    - 解释你的决策和更改
5.    - 寻求澄清如果反馈不明确
7. ### 代码审查流程
9. 理解代码审查过程可以帮助你更顺利地通过审查并合并你的贡献。
11. #### 审查标准
13. Fedora文档审查通常关注以下方面：
15. 1. **技术准确性**：
16.    - 命令和步骤是否正确
17.    - 信息是否与当前软件版本一致
19. 2. **文档质量**：
20.    - 语言是否清晰简洁
21.    - 结构是否合理
22.    - 是否符合风格指南
24. 3. **格式和构建**：
25.    - AsciiDoc语法是否正确
26.    - 文档是否能正确构建
27.    - 链接是否有效
29. 4. **一致性**：
30.    - 术语使用是否一致
31.    - 格式是否与文档其他部分一致
33. #### 审查类型
35. 1. **自动化检查**：
36.    - 构建系统自动检查语法错误
37.    - 链接检查器验证链接有效性
38.    - 拼写检查器标记可能的拼写错误
40. 2. **人工审查**：
41.    - 文档团队成员审查内容和结构
42.    - 技术专家验证技术准确性
43.    - 编辑检查语言和风格
45. #### 通过审查的技巧
47. 1. **提交前自检**：
48.    ```bash
49.    # 检查拼写
50.    aspell --lang=en_US check file.adoc
51.    
52.    # 检查链接
53.    linkchecker file.html
54.    
55.    # 检查语法
56.    proselint file.adoc

复制代码

1. 小而专注的更改：每个合并请求解决一个明确的问题避免在一个PR中混合多个不相关的更改
2. 每个合并请求解决一个明确的问题
3. 避免在一个PR中混合多个不相关的更改
4. 清晰的提交消息：
“`
格式：组件：简短描述

小而专注的更改：

• 每个合并请求解决一个明确的问题
• 避免在一个PR中混合多个不相关的更改

清晰的提交消息：
“`
格式：组件：简短描述

详细描述更改内容和原因。
   如果适用，关联问题编号。

示例：
   docs: Fix broken links in Installation Guide

Updated outdated repository links in section 4.2.
   Added new links to official Fedora documentation.

Fixes: #12345

2. 4. **响应审查意见**：
3.    - 感谢审查者的时间和反馈
4.    - 解释你的决策或提出替代方案
5.    - 及时进行必要的更改
7. ### 发布和更新流程
9. 了解文档发布流程有助于你理解贡献如何最终到达用户。
11. #### 文档发布周期
13. 1. **Fedora版本发布**：
14.    - 主要文档更新与Fedora版本发布同步
15.    - 通常每6个月一次（春季和秋季）
17. 2. **持续更新**：
18.    - 错误修复和小更新可以随时发布
19.    - 重要安全更新会优先发布
21. #### 发布流程
23. 1. **构建阶段**：
24.    - 文档团队触发构建过程
25.    - 自动化系统构建所有语言版本
26.    - 进行质量检查和测试
28. 2. **发布阶段**：
29.    - 构建的文档部署到生产服务器
30.    - 更新索引和导航
31.    - 公告新版本可用
33. 3. **发布后**：
34.    - 监控用户反馈和问题报告
35.    - 收集改进建议
36.    - 开始下一周期规划
38. #### 文档更新策略
40. 1. **版本特定文档**：
41.    - 每个Fedora版本有其特定文档
42.    - 旧版本文档通常只接收关键更新
44. 2. **持续更新文档**：
45.    - 某些文档（如Fedora Magazine文章）持续更新
46.    - 不特定于某个Fedora版本
48. 3. **翻译更新**：
49.    - 翻译团队在英文文档更新后开始工作
50.    - 翻译版本可能稍后发布
52. 通过理解并遵循这些贡献流程，你可以有效地参与Fedora文档项目，确保你的贡献能够顺利地被审查、合并并最终发布给用户。
54. ## 常见问题与解决方案
56. ### 技术问题解决
58. 在参与Fedora文档项目时，你可能会遇到各种技术问题。以下是一些常见问题及其解决方案。
60. #### Git相关问题
62. **问题1：推送时出现权限错误**
63. ```bash
64. error: Permission denied (publickey).
65. fatal: Could not read from remote repository.

复制代码

解决方案：

1. 检查SSH密钥是否正确配置：cat ~/.ssh/id_ed25519.pub
2. 确保公钥已添加到FAS账户
3. 测试SSH连接：ssh -T git@pagure.io

2. cat ~/.ssh/id_ed25519.pub

复制代码

2. ssh -T git@pagure.io

复制代码

问题2：合并冲突

2. Auto-merging file.adoc
3. CONFLICT (content): Merge conflict in file.adoc
4. Automatic merge failed; fix conflicts and then commit the result.

复制代码

解决方案：

1. 打开冲突文件，查找冲突标记（<<<<<<<,=======,>>>>>>>）
2. 手动编辑文件，保留需要的更改，删除冲突标记
3. 标记冲突已解决：git add file.adoc
git commit

2. git add file.adoc
3. git commit

复制代码

问题1：Antora构建失败

2. ERROR: failed to load playbook: playbook.yml

复制代码

解决方案：

1. 检查playbook.yml文件是否存在且格式正确
2. 确保所有必需的组件都已安装：npm install -g @antora/cli @antora/site-generator-default
3. 检查Antora版本：antora --version

2. npm install -g @antora/cli @antora/site-generator-default

复制代码

2. antora --version

复制代码

问题2：AsciiDoc语法错误

2. asciidoc: file.adoc: line 10: ERROR: unterminated list item

复制代码

解决方案：

1. 检查列表格式是否正确
2. 确保所有列表项都正确缩进
3. 验证所有块元素都正确关闭

问题1：文本编辑器不识别AsciiDoc语法

解决方案：

1. 安装适当的编辑器插件：VS Code：安装”AsciiDoc”扩展Vim：安装vim-asciidoc插件Emacs：安装adoc-mode
2. VS Code：安装”AsciiDoc”扩展
3. Vim：安装vim-asciidoc插件
4. Emacs：安装adoc-mode
5. 配置文件关联：在编辑器设置中将.adoc文件关联到AsciiDoc模式
6. 在编辑器设置中将.adoc文件关联到AsciiDoc模式

安装适当的编辑器插件：

• VS Code：安装”AsciiDoc”扩展
• Vim：安装vim-asciidoc插件
• Emacs：安装adoc-mode

配置文件关联：

• 在编辑器设置中将.adoc文件关联到AsciiDoc模式

问题2：拼写检查器标记技术术语

解决方案：

1. 创建自定义词典：# 创建个人词典
echo "personal_ws-1.1 en 10" > ~/.aspell.en.pws
echo "Fedora" >> ~/.aspell.en.pws
echo "dnf" >> ~/.aspell.en.pws
echo "systemd" >> ~/.aspell.en.pws
2. 配置Aspell使用个人词典：aspell --personal=./.aspell.en.pws check file.adoc

创建自定义词典：

2. # 创建个人词典
3. echo "personal_ws-1.1 en 10" > ~/.aspell.en.pws
4. echo "Fedora" >> ~/.aspell.en.pws
5. echo "dnf" >> ~/.aspell.en.pws
6. echo "systemd" >> ~/.aspell.en.pws

复制代码

配置Aspell使用个人词典：

2. aspell --personal=./.aspell.en.pws check file.adoc

复制代码

写作障碍克服

文档写作过程中可能会遇到各种创作障碍。以下是一些常见问题及解决策略。

问题：不知道如何组织文档结构

解决方案：

1. 参考现有Fedora文档的结构
2. 使用思维导图规划内容：
“`bash安装思维导图工具sudo dnf install freeplane

参考现有Fedora文档的结构

使用思维导图规划内容：
“`bash

sudo dnf install freeplane

# 创建思维导图规划文档结构
   freeplane

2. 3. 遵循"从一般到具体"的原则组织内容
3. 4. 使用标题层级创建清晰的层次结构
5. #### 技术内容解释困难
7. **问题：难以用简单语言解释复杂技术概念**
9. 解决方案：
10. 1. 使用类比和比喻：

复制代码

容器就像集装箱，标准化了软件的运输方式。

2. 2. 分解复杂概念为简单步骤：

复制代码

理解SELinux模式：

1. Enforcing模式：规则被严格执行，违反将被阻止。
2. Permissive模式：规则被检查但不执行，违反只记录日志。
3. Disabled模式：不检查也不执行任何规则。
“`
4. 提供具体示例：
“`
要启用SELinux：

Enforcing模式：规则被严格执行，违反将被阻止。

Permissive模式：规则被检查但不执行，违反只记录日志。

Disabled模式：不检查也不执行任何规则。
“`

提供具体示例：
“`
要启用SELinux：

[source,bash]

# 检查当前状态
   sestatus

# 临时设置为Enforcing模式
   sudo setenforce 1

2. #### 保持更新和准确性
4. **问题：如何确保文档内容与软件最新版本保持一致**
6. 解决方案：
7. 1. 定期测试文档中的步骤：
8.    ```bash
9.    # 在虚拟环境中测试步骤
10.    sudo dnf install libvirt virt-install
11.    virt-install --name test-doc --memory 2048 --disk size=10 --cdrom fedora.iso

复制代码

1. 订阅相关软件的邮件列表和公告
2. 设置自动化检查：
“`bash创建脚本检查命令是否仍然有效#!/bin/bash

订阅相关软件的邮件列表和公告

设置自动化检查：
“`bash

#!/bin/bash

commands=(“dnf update” “systemctl status firewalld”)

for cmd in “${commands[@]}”; do

2. if ! eval "$cmd" >/dev/null 2>&1; then
3.    echo "Command '$cmd' failed, may need documentation update"
4. fi

复制代码

done

2. 4. 与开发团队保持沟通，了解即将到来的变更
4. ### 社区互动困惑
6. 与开源社区互动可能会带来一些挑战。以下是一些常见问题及应对策略。
8. #### 沟通障碍
10. **问题：不确定如何适当地提出问题或请求帮助**
12. 解决方案：
13. 1. 遵循"先搜索，后提问"原则
14. 2. 使用有效的提问模板：

复制代码

主题：[文档] 安装指南第3节中的步骤不清晰

我正在尝试按照安装指南第3节的说明进行操作，但在步骤”配置分区”时遇到困难。

我已经尝试：

• 按照文档说明选择”自定义分区”
• 查看了相关截图，但界面有所不同

具体问题：
   我找不到文档中提到的”创建新分区表”按钮。

环境：

• Fedora 35 Workstation
• 安装媒体：Fedora-Workstation-Live-x86_64-35-1.2.iso

任何指导将不胜感激。

2. 3. 选择适当的沟通渠道：
3.    - 简单问题：IRC/Matrix
4.    - 复杂讨论：邮件列表
5.    - 错误报告：Bugzilla
7. #### 处理批评和反馈
9. **问题：如何建设性地处理对文档的批评**
11. 解决方案：
12. 1. 分离个人和工作：批评针对的是文档，不是你个人
13. 2. 寻求具体反馈：

复制代码

感谢你的反馈。你能指出具体哪些部分不够清晰吗？这样我可以更有针对性地改进。

2. 3. 将批评视为改进机会
3. 4. 记录常见反馈，用于改进未来文档
5. #### 融入社区
7. **问题：作为新贡献者，如何更好地融入社区**
9. 解决方案：
10. 1. 从小任务开始，建立信任
11. 2. 参加社区活动和会议：
12.    ```bash
13.    # 加入Matrix聊天室
14.    # 使用Element客户端
15.    element-desktop
16.    
17.    # 加入Fedora文档房间
18.    # https://matrix.to/#/#fedora-docs:fedoraproject.org

复制代码

1. 寻找导师：大家好，我是新加入的文档贡献者。有没有经验丰富的成员愿意指导我完成第一个任务？
2. 定期分享你的进展和学到的经验

2. 大家好，我是新加入的文档贡献者。有没有经验丰富的成员愿意指导我完成第一个任务？

复制代码

时间管理建议

平衡文档贡献与其他生活责任可能具有挑战性。以下是一些时间管理策略。

问题：如何在不感到压力的情况下持续贡献

解决方案：

1. 使用SMART目标设定：Specific（具体）：每周修复3个拼写错误Measurable（可衡量）：完成一个小节的重写Achievable（可实现）：贡献2小时/周Relevant（相关）：专注于你熟悉的领域Time-bound（有时限）：本月底前完成
2. Specific（具体）：每周修复3个拼写错误
3. Measurable（可衡量）：完成一个小节的重写
4. Achievable（可实现）：贡献2小时/周
5. Relevant（相关）：专注于你熟悉的领域
6. Time-bound（有时限）：本月底前完成
7. 创建贡献日历：
“`bash使用任务管理工具sudo dnf install gnome-todo

使用SMART目标设定：

• Specific（具体）：每周修复3个拼写错误
• Measurable（可衡量）：完成一个小节的重写
• Achievable（可实现）：贡献2小时/周
• Relevant（相关）：专注于你熟悉的领域
• Time-bound（有时限）：本月底前完成

创建贡献日历：
“`bash

sudo dnf install gnome-todo

# 创建定期任务
   # 每周六上午9-11点：文档贡献时间

2. 3. 设定最小贡献目标：即使只有15分钟，也可以修复一个小错误
4. #### 高效工作流程
6. **问题：如何在有限时间内最大化贡献效率**
8. 解决方案：
9. 1. 创建工作模板：
10.    ```bash
11.    # 创建贡献脚本模板
12.    #!/bin/bash
13.    
14.    # 1. 同步最新代码
15.    git pull upstream main
16.    
17.    # 2. 创建新分支
18.    branch_name="fix-$(date +%Y%m%d)-$1"
19.    git checkout -b $branch_name
20.    
21.    # 3. 编辑文件
22.    # vim $2
23.    
24.    echo "Branch $branch_name created. Ready to edit $2."

复制代码

使用方法：./contribute.sh typo filename.adoc

1. 批量处理类似任务：一次性修复多个拼写错误同时更新多个相关链接
2. 一次性修复多个拼写错误
3. 同时更新多个相关链接
4. 利用碎片时间：在通勤时阅读邮件列表使用移动设备审查简单更改
5. 在通勤时阅读邮件列表
6. 使用移动设备审查简单更改

批量处理类似任务：

• 一次性修复多个拼写错误
• 同时更新多个相关链接

利用碎片时间：

• 在通勤时阅读邮件列表
• 使用移动设备审查简单更改

问题：如何保持长期贡献而不感到倦怠

解决方案：

1. 定期休息：设定明确的贡献和休息时间
2. 多样化任务：交替进行不同类型的贡献
3. 庆祝小成就：记录并认可你的每个贡献
4. 寻求支持：与其他贡献者分享挑战和成功

持续参与的策略

长期参与开源项目需要策略和动力。以下是一些帮助你持续贡献的方法。

问题：如何保持长期贡献的动力

解决方案：

1. 跟踪你的影响：
“`bash创建贡献统计脚本#!/bin/bash

跟踪你的影响：
“`bash

#!/bin/bash

echo “=== 我的Fedora文档贡献统计 ===”
   echo “提交次数:\((git log --author="Your Name" --oneline | wc -l)"
   echo "合并请求数: \)(git log –merges –author=“Your Name” –oneline | wc -l)”
   echo “文件修改数: $(git log –author=“Your Name” –name-only –pretty=format: | sort | uniq | wc -l)”

2. 定期运行并查看你的贡献增长
4. 2. 设定学习目标：将每个贡献视为学习新技能的机会
5. 3. 与用户互动：阅读用户反馈，了解你的工作如何帮助他人
6. 4. 参与社区活动：参加Fedora活动，感受社区能量
8. #### 技能发展
10. **问题：如何通过文档贡献发展个人技能**
12. 解决方案：
13. 1. 创建个人学习计划：

复制代码

本季度学习目标：

• 掌握高级AsciiDoc技巧
• 学习文档本地化基础
• 改进技术写作能力
“`

1. 寻求反馈并应用：
“`
我正在努力改进我的技术写作。如果你审查我的PR，能否特别关注：步骤说明的清晰度术语使用的一致性整体文档结构”`
2. 步骤说明的清晰度
3. 术语使用的一致性
4. 整体文档结构
5. 参与相关培训：Fedora文档团队定期举办的工作坊开源文档会议（如Write the Docs）在线课程（技术写作、Git等）
6. Fedora文档团队定期举办的工作坊
7. 开源文档会议（如Write the Docs）
8. 在线课程（技术写作、Git等）

寻求反馈并应用：
“`
我正在努力改进我的技术写作。如果你审查我的PR，能否特别关注：

• 步骤说明的清晰度
• 术语使用的一致性
• 整体文档结构

”`

参与相关培训：

• Fedora文档团队定期举办的工作坊
• 开源文档会议（如Write the Docs）
• 在线课程（技术写作、Git等）

问题：如何从文档贡献者发展为社区领导者

解决方案：

1. 指导新贡献者：我注意到你是新加入的贡献者。如果你需要任何帮助或指导，我很乐意分享我的经验。
2. 主动承担更多责任：志愿维护特定文档部分帮助组织文档团队活动参与战略规划讨论
3. 志愿维护特定文档部分
4. 帮助组织文档团队活动
5. 参与战略规划讨论
6. 分享你的经验：在博客上记录你的贡献之旅在会议上演讲创建教程帮助新贡献者
7. 在博客上记录你的贡献之旅
8. 在会议上演讲
9. 创建教程帮助新贡献者

指导新贡献者：

2. 我注意到你是新加入的贡献者。如果你需要任何帮助或指导，我很乐意分享我的经验。

复制代码

主动承担更多责任：

• 志愿维护特定文档部分
• 帮助组织文档团队活动
• 参与战略规划讨论

分享你的经验：

• 在博客上记录你的贡献之旅
• 在会议上演讲
• 创建教程帮助新贡献者

通过解决这些常见问题并应用建议的解决方案，你可以克服参与Fedora文档项目中的各种挑战，成为一名有效且满足的长期贡献者。

结语

加入Fedora文档贡献者行列是一段充满挑战和回报的旅程。通过本文提供的指南，你已经了解了Fedora文档项目的写作标准、协作工具使用方法、社区沟通技巧以及完整的贡献流程。现在，是时候将这些知识付诸实践，成为Fedora开源社区的一员了。

作为文档贡献者，你不仅帮助Fedora用户更好地理解和使用这个优秀的操作系统，也在提升自己的技术写作能力、协作能力和专业技能。每一份文档改进，无论大小，都对整个Fedora生态系统产生积极影响。

记住，开源社区的力量在于集体智慧和协作精神。你的独特视角和技能将为Fedora文档项目带来新的活力。不要害怕犯错，因为社区会支持你学习和成长。从小任务开始，逐步建立信心，最终你将成为一名经验丰富的文档贡献者。

进一步学习的资源

要继续你的Fedora文档贡献之旅，以下资源将对你有所帮助：

1. 官方文档：Fedora文档项目主页：https://docs.fedoraproject.org/en-US/fedora-docs/文档贡献指南：https://docs.fedoraproject.org/en-US/fedora-docs/contributing/
2. Fedora文档项目主页：https://docs.fedoraproject.org/en-US/fedora-docs/
3. 文档贡献指南：https://docs.fedoraproject.org/en-US/fedora-docs/contributing/
4. 社区资源：Fedora文档团队Wiki：https://fedoraproject.org/wiki/Docs_Project邮件列表：docs@lists.fedoraproject.orgIRC/Matrix：#fedora-docs
5. Fedora文档团队Wiki：https://fedoraproject.org/wiki/Docs_Project
6. 邮件列表：docs@lists.fedoraproject.org
7. IRC/Matrix：#fedora-docs
8. 学习材料：AsciiDoc文档：https://asciidoctor.org/docs/Git教程：https://git-scm.com/docs/gittutorial技术写作最佳实践：https://developers.google.com/tech-writing
9. AsciiDoc文档：https://asciidoctor.org/docs/
10. Git教程：https://git-scm.com/docs/gittutorial
11. 技术写作最佳实践：https://developers.google.com/tech-writing
12. 相关工具：Antora文档：https://docs.antora.org/antora/latest/Pagure用户指南：https://pagure.io/pagure
13. Antora文档：https://docs.antora.org/antora/latest/
14. Pagure用户指南：https://pagure.io/pagure

官方文档：

• Fedora文档项目主页：https://docs.fedoraproject.org/en-US/fedora-docs/
• 文档贡献指南：https://docs.fedoraproject.org/en-US/fedora-docs/contributing/

社区资源：

• Fedora文档团队Wiki：https://fedoraproject.org/wiki/Docs_Project
• 邮件列表：docs@lists.fedoraproject.org
• IRC/Matrix：#fedora-docs

学习材料：

• AsciiDoc文档：https://asciidoctor.org/docs/
• Git教程：https://git-scm.com/docs/gittutorial
• 技术写作最佳实践：https://developers.google.com/tech-writing

相关工具：

• Antora文档：https://docs.antora.org/antora/latest/
• Pagure用户指南：https://pagure.io/pagure

行动号召

现在，你已经掌握了成为Fedora文档贡献者所需的知识和技能。以下是你可以立即采取的行动步骤：

1. 创建Fedora账户并加入文档邮件列表
2. 选择一个小任务开始你的贡献之旅
3. 在社区中介绍你自己，表达你的兴趣和目标
4. 完成你的第一个贡献，无论大小
5. 分享你的经验，帮助其他新贡献者加入

记住，每一个伟大的贡献者都从第一步开始。你的旅程现在开始，我们期待在Fedora文档社区中见到你！