官方和社区文档的新主页

公告
1

我很高兴地宣布我们对文档处理方式进行了一些更新，以确保清晰度和协作性，同时保持所提供信息的质量。请继续阅读以了解我们新的文档设置如何工作。

:writing_hand: 官方文档

我们已更新 Documentation（文档）类别，专门用于官方文档。这意味着其子类别中的所有内容均由 Discourse 团队成员维护，确保信息准确且最新。如果您正在寻找最权威的指南和参考资料，这里就是您的最佳选择！

为什么只有团队成员？

将官方文档的创建和编辑限制在我们的团队内，可以确保一致性和可靠性。我们的目标是为从新用户到经验丰富的开发者的每个人提供精确、维护良好的资源。所有社区成员仍然可以回复这些主题，以讨论内容或建议更改。

:people_hugging: 社区维基

别担心，您的贡献也有充足的空间！所有社区贡献的文档现在都可以在 Community wiki（社区维基）类别中找到。这里汇集了我们充满活力的社区的专业知识、技巧和集体知识。

谁可以贡献？

信任等级为 2 及以上的用户可以在 Community wiki（社区维基）中创建和编辑主题。这使得经验丰富的用户能够分享他们的知识，为我们的社区资源增添丰富性和多样性。这也意味着受信任的社区成员可以编辑他们发现不正确或过时的任何社区文档。

:question: 为什么要做这个改变？

这项政策旨在平衡官方、已维护文档的需求以及我们的社区提供的宝贵意见。它还为寻求信息的用户提供了清晰的结构——无论他们需要官方指导还是社区建议。

我们重视你们所有人的贡献，并相信将您的文档贡献转移到一个专门的空间将有助于它们蓬勃发展，并获得应有的关注。

:derek_pointing: 我们需要你！

社区维基已经为成为一个强大的、社区驱动的学习和知识共享空间打下了良好的基础，我们非常希望得到您更多的意见。如果您有很棒的教程、配置或建议，Community wiki（社区维基）期待您的贡献！

您可以在此处找到此文档政策的永久链接：

10 个赞
2

我能知道“Scribe”徽章会怎么样吗？

4 个赞
3

是否有直接的方法可以同时搜索这两个文档源？我知道我可以搜索多个类别，但这比仅通过自动完成添加“Documentation”更麻烦。

我认为我可以使用 in:docs 代替，因为这两个类别都已添加到其中？in:kb（也适用于 https://meta.discourse.org/t/discourse-docs/130172）似乎不起作用。

那么它如何处理子类别呢？例如，我如何搜索为用户编写的所有信息？我能否同时搜索 #community-wiki:users 和 #documentation:using-discourse？

5 个赞
4

一个经典的标签示例。但是……那样的话标签数量会非常庞大，几乎不可能管理。

3 个赞
5

Scribe 徽章已更新，以涵盖对社区 wiki 的贡献 :slight_smile:

3 个赞
6

是的，您可以使用 in:docs，它将同时搜索 Documentation 和 Community wiki 中的主题。

搜索将包含子类别中的主题，因此它们已包含在结果中。

为此，您需要在搜索中指定 categories:users,using-discourse。

2 个赞
7

但是所有这些都需要相当深入的 Discourse 知识，因为其中没有一个在（高级）搜索界面中得到支持。
文档不应该尽可能易于搜索吗？

5 个赞
10

我认为这反而凸显了我们可以改进 Discourse UI 的地方。特别是，允许在高级搜索中选择多个类别，以及其他一些功能。

这提供了一个绝佳的机会和额外的动力来处理这类更新，所以我们会看看能做些什么！我们会讨论这个问题，并在此处分享任何更新。

4 个赞