跳至内容

简介

为什么要有这个版块?

到了 2024 年底,很明显,Rocky Linux 文档缓存中的并非所有文档都是操作指南。我们需要一个地方进行更长、更深入的解释。这个博客就是为此而生。

谁可以在这里写?

任何拥有 GitHub 凭证的人都可以提交建议的文章。请查阅 贡献版块 中的文档以开始。

注意

如果您没有 GitHub 凭证但仍想为该版块撰写内容,请通过此页面底部的 Mattermost 频道链接与我们联系。

您应该确保您的文档符合该版块的要求。例如:

  • 它适合放在这里吗?这是值得分享的信息吗?这是一篇博客风格的文档吗?
  • 它是否扩展了对文档编写者很重要的问题?
  • 提交的内容是否会提高 Rocky Linux 所有文档的整体质量?

什么类型的信息?

前两篇文档应该能让您了解什么内容适合。在整个 2024 年,我们付出了共同的努力,以消除或大幅减少操作指南中的被动语态。文档 主动语态:简单清晰沟通之道 描述了主动语态在文档语气、易读性和理解性以及翻译成其他语言的简化方面的重要性。文档 开源:为什么它从不带连字符 讨论了关于这个主题的争论以及我们决定不加连字符的原因。明白了吗?这些是信息性文档,不包含操作指南信息,除非作为示例。

这个博客的增长?

这组文档的增长速度可能比操作指南文档慢。这是符合预期的。这里文档的质量和契合度是最重要的。

反馈

与整个文档项目一样,您可以在我们的 文档 Mattermost 频道 中提供反馈。

作者:Steven Spencer