介绍
为什么有这个部分?¶
在 2024 年末,很明显 Rocky Linux 文档缓存中的每个文档并非都是操作指南。 我们需要一个更长期、更深入的解释点。 这就是写这篇博客的原因。
谁可以在这里写?¶
任何人只要有 GitHub 凭证都可以在此提交建议文章。 查看 贡献部分 中的文档来开始吧。
注意
如果您没有 GitHub 凭据,但仍想为此部分编写内容,请通过本页底部的 Mattermost 频道链接与我们联系。
您应该确保您的文档符合本章节的要求。 例如:
- 它适合这里吗? 它是值得共享的信息吗? 它是博客风格的文档吗?
- 它是否扩展了对文档作者很重要的主题?
- 这次提交会提高所有 Rocky Linux 文档的整体质量吗?
什么样的信息?¶
这里的前两份文档应该能让你了解哪些内容是合适的。 整个 2024 年,我们一致努力消除或大幅减少操作文件中的被动语态。 文档 主动语态:通向简洁清晰沟通的路径 阐述了在文档中使用主动语态的重要性——它能塑造更清晰的表达基调、提升可读性和理解性,同时简化翻译成其他语言的过程。 开源:为什么不应使用连字符 文档描述了关于这个主题的大争论以及我们决定不使用连字符的原因。 明白了吗? 这些是信息性文档,不包括如何操作信息,除非可能作为示例。
博客的成长?¶
这组文档的增长速度可能比操作指南文档慢。 这正如预期的那样。 这里的文档质量和适合性是最重要的。
反馈¶
与整个文档项目一样,您可以在我们的 文档 Mattermost 频道 中提供反馈。
Author: Steven Spencer