ArchWiki:贡献

出自 ArchWiki

相关文章

Arch Linux 的行为准则管辖所有 Arch 项目。

ArchWiki 致力于成为清晰、全面和专业的文档典范。为了达到这个目标，我们必须以合理和有效的方式组织工作：本文尝试概括地解释您可以提供帮助以完成的最重要任务。

这是一个社区共同努力的结果，但是如果您认真对待这项任务，则可能会获得作为 wiki 维护者的正式职位。

3 条基本规则

所有贡献者，包括新手，都应尽力遵守 3 条简单的规则，以表示对 wiki 其他用户的尊重：#始终正确使用编辑摘要，#不要一次进行复杂的编辑 和 #在讨论页中声明文章重写。

所有 wiki 贡献者都必须假设并期望其他用户迟早会检查他们的编辑，并通过遵循这些规则使其尽可能快速和容易地尊重他们这样做的权利。熟悉协作软件项目的人员将很容易理解 wiki 编辑摘要和 git 提交消息之间的类比，以及 wiki 编辑差异和 git 差异之间的类比。

警告： 任何不遵守这些基本规则的文章编辑，以及因此无法以合理的努力理解的编辑，可能会被完全回退，而不会有任何其他警告，尤其是在影响热门文章时。

始终正确使用编辑摘要

编辑摘要是位于主编辑区域下方和保存更改或保存页面按钮上方的小文本框。始终以简洁的方式写明已完成的操作和原因非常重要。请注意，内部 wiki 链接在编辑摘要中有效，因此请使用它们链接到任何相关的讨论或文章； 同样，粘贴任何指向相关编辑差异或外部资源的 URL，例如论坛主题或邮件列表。

仅在小编辑的情况下，例如语法或拼写更正或简单地重写句子，可以省略“原因”部分； 类似地，开始新的讨论或回复现有讨论不需要在编辑摘要中重述消息。

注意： 当点击节标题上的编辑时，/* Section name */ 会预填充到摘要字段中。这不是注释语法。/* 和 */ 之间的文本会变成指向页面某个章节的链接。在其后附加您的编辑摘要。
提示
  • 查看最近更改中的编辑摘要，以了解您应该在摘要中写些什么，但请注意，不幸的是，并非所有用户都了解这些指南。
  • 使用诸如 Special:Diff/359881/next 之类的链接作为指向差异的可点击引用，有关语法详细信息，请参阅 mw:Help:Diff。

不要一次进行复杂的编辑

如果您想对页面进行广泛的更改，无论是普通文章还是讨论页面，请始终将您的工作分成几个简单的编辑，例如根据完成它所需的各种逻辑步骤。 如果有疑问，请使用显示更改按钮预览生成的 diff，并思考另一个用户是否能够理解它，同时还要考虑上面解释的编辑摘要。 一些生成令人困惑的差异的常见操作是

  • 在文章中移动一个章节并同时编辑其内容。 解决方案：移动未更改的章节，保存，然后在后续编辑中更改其内容。
  • 同时重新排序文章的多个章节。 解决方案：每次编辑仅移动一个章节。
注意： 这种做法自然会增加 最近更改 中的条目数量：完全不必为此担心，用户可以通过启用在最近更改和监视列表中按页面对更改进行分组设置（位于偏好设置 > 最近更改 > 高级选项下）轻松过滤该列表。

在讨论页中声明文章重写

如果您想从根本上重组或重写一篇文章或一组文章，请首先在适当的讨论页中宣布并解释您的意图，给任何其他感兴趣的用户一些合理的时间来回复和分享他们的观点。

请记住，宣布预期的更改并不能免除 #始终正确使用编辑摘要 和 #不要一次进行复杂的编辑。

最重要的任务

在本文的其余部分，您将看到您可以为 wiki 做出贡献的各种方式。 然而，在这些方式中，您应该认为有一项比其他任何方式都重要得多：将您喜欢的文章添加到您的监视列表，并保护它们免受适得其反的编辑。

每天，ArchWiki 都会收到来自许多不同用户的几十个编辑：虽然这些更改中的大多数实际上是改进，但只需要一个编辑，通常是出于善意进行的，就可能会不准确地更改整段或整个章节的含义，甚至有时会不合理地完全删除它； 如果没有注意到，这将破坏您和所有其他先前编辑者所做的宝贵工作。 不幸的是，这种情况比您预期的更频繁地发生：官方 wiki 工作人员确实尽力过滤和修复适得其反的编辑，但您永远不应完全依赖他们，这既是因为他们和您一样，在 wiki 上花费的时间有限，也是因为他们不是全知全能的，而且您对您喜欢的文章中处理的主题的知识很可能比他们的更丰富。 总的来说，如果用户只专注于编写新内容，而不关心他们的贡献发生了什么，那么 wiki 就无法正常工作。

幸运的是，有一种非常简单的方法可以让您关注您贡献过的文章或您最喜欢或最了解的文章：在每篇文章的顶部都有一个“监视”链接，通过点击它，该文章将被添加到您的监视列表中。 然后，您将能够在 Special:Watchlist 中关注更改，或者通过选择在监视的文章收到更新时在 Special:Preferences#mw-prefsection-personal-email 的“电子邮件选项”字段中收到电子邮件通知； 您正在关注的页面也会在 Special:RecentChanges 中以粗体突出显示。 最后，监视列表的偏好设置位于 Special:Preferences#mw-prefsection-watchlist 中：在这些选项中，您甚至可以选择自动开始监视您创建或编辑的页面。

如果您注意到您的监视列表中的文章收到了不准确的编辑，或者您只是不理解它，我们强烈建议您修复它（如果可能），或者在文章的讨论页或责任作者的讨论页中发起讨论。 要保持最新状态，您可以通过 Special:Preferences#mw-prefsection-echo 为讨论主题配置 Web/电子邮件通知。

资源

以下是包含贡献所需信息的页面列表

  • Help:文章命名指南讨论了有效的文章命名策略和注意事项，以确保 wiki 的可读性并改进导航。 在创建新页面之前阅读它。
  • Help:编辑概述了广为人知的 MediaWiki 标记和 ArchWiki 特定的指南。 对于任何有志于贡献的人来说，都是必读之物。
  • Help:讨论指导您如何在讨论页中与人讨论。
  • Help:样式提供了 ArchWiki 文章中样式标准化的指南。
  • Help:分类解释了如何设置页面分类、如何创建缺失的分类页面以及如何将页面移动到不同的分类。
  • ArchWiki 翻译团队提供了创建新翻译页面的逐步介绍。 按照它将页面翻译成您自己的语言。
  • Help:i18n 是 ArchWiki 国际化和本地化的综合指南。
  • Help:程序是复杂操作的有用检查清单的集合。

请参阅 Category:帮助 以获取所有帮助文章。

创建

确保您了解 ArchWiki 的理念，并考虑其他人可能想阅读什么（有关想法，请参阅 ArchWiki:请求）。 如前所述，wiki 的范围非常广泛。

与维护者交谈，以获得协调大型项目的帮助。

Help:编辑#创建页面涵盖了在主命名空间中创建新文章的步骤。

wiki 的子页面功能（文章/子页面）也适用于您的用户页面。 使用它可以创建一个空白子页面上的草稿。 请注意，用户页面内容不得分类，但可以使用所有其他功能。 完成草稿后，您可以简单地将子页面移动到其新名称。 移动后，请仅添加相关的文章状态模板。 您越好地描述状态模板的原因，用户就越容易与您协作#改进 wiki。

改进

内容编辑、校对和更新在任何 wiki 上都是永无止境的任务。 如果您想提供帮助，只需注册一个帐户并开始展示您的魔力。

非 Arch 用户

任何人都可以注册帐户：欢迎非 Arch 用户贡献适用于其他 Linux 发行版或操作系统的内容，只要他们确信它也适用于 Arch Linux。 特别是，文章必须专门为 Arch 用户编写，因此

  • 不要添加其他 Linux 发行版或操作系统特有的评论； 例如，Fedora 用户为 systemd 页面做出贡献是可以的，但提及新添加的内容在 Fedora 上有效将被编辑掉，因为不相关；
  • 不要用可能适用于更广泛的操作系统的替代方案替换提及 Arch 特定的约定、术语或实用程序。

维护

  • 帮助巡逻最近更改，报告和修复有问题的编辑。
  • 使用适当的文章状态模板标记文章，例如 {{Out of date}}、{{Accuracy}}、{{Remove}}、{{Archive}} 等。
  • 将您喜欢的文章添加到您的监视列表，并保护它们免受适得其反的编辑（#最重要的任务）。
  • 参与各种讨论页中的讨论：大多数用户将有兴趣关注 此链接 中对通用讨论的最新帖子。 维护特定的帖子列在 [1]、[2]、[3] 和 [4] 中。

组织

对文章进行排序、分类和移动已成为所有 wiki 维护者实施和改进分类树的主要任务。

翻译

添加或改进翻译； 确保翻译彼此同步。 一些语言已经启动了协作项目（见下表），以有效地组织文章的翻译。 当您开始翻译文章时，请考虑加入您语言的翻译团队或至少通知它。

某些语言使用外部 wiki，它们可能需要不同的翻译步骤。 Help:i18n 包含外部 wiki 的列表。

特殊消息翻译

Arch Wiki 中使用了一些特殊消息，请在以下链接中提供您语言的翻译

  • 也在（分类树中的消息）：在此处添加翻译 here
  • Talkpagetext：在此处添加翻译 here

头脑风暴

为了与其他用户实时协调贡献，有一个官方专用的 #archlinux-wiki IRC 频道。 如果不确定从哪里开始，或者您对编辑他人的工作感到尴尬，您也可以通过在 论坛 & Wiki 讨论 区的 Arch Linux 论坛 上发布想法和建议来做出贡献。

后端维护

使用 Arch Linux GitLab 报告错误，并为 ArchWiki 后端贡献修复和改进。 MediaWiki 配置维护在 基础架构存储库中。

投诉

如果您对 wiki 的审核或管理方式有任何通用的负面评价或投诉，请在 ArchWiki 讨论:维护团队 中留言。 当然，应该没有必要说明确实可以使用文明和尊重的语气来抱怨某事 :)

所有关于投诉和评论的适当场所和方法都在 ArchWiki:维护团队#谁、何时以及如何联系 中概述。

已从“https://wiki.archlinux.org.cn/index.php?title=ArchWiki:Contributing&oldid=823353”检索