Project:贡献

来自 Arch Linux 中文维基
(重定向自Project:Contributing

Arch Linux 行为准则 管理着所有 Arch 项目。

ArchWiki 致力于成为一个清晰、全面、专业的文档。为了达到这一目的,我们将工作划分为不同的任务。本文主要介绍你可以帮助完善 ArchWiki 的主要任务。

这是一个来自社区、服务社区的工作。如果想更进一步,可以申请成为wiki 维护者

三个基本原则[编辑 | 编辑源代码]

有三个基本的原则需要贡献者遵守,不管您是新手还是老用户。这是对其它用户的尊重

每个 Wiki 贡献者都必须明白,你的编辑早晚会被其它用户检查和编辑,遵循此建议可以方便其它用户理解您的编辑。若你参加过软件合作项目,应能理解维基编辑摘要和git提交说明(commit message)、维基编辑差异和git diff的相似性。

警告: 不遵守此规则的编辑可能会被直接回退,而且回退前不会再另行通知。访问量高的页面尤其如此。

总是正确使用编辑摘要[编辑 | 编辑源代码]

编辑摘要(或称变更摘要)是编辑页面的编辑区域下方、保存按钮上方的文本框。每次编辑,都需要有充足且简洁的信息说明“做了什么”和“为什么”。内部链接在编辑摘要中也生效,可以链接到相关的讨论或文章;也可以贴上链接到编辑差异、或是外部的论坛帖子或者邮件列表的URL。

只有当编辑是小编辑(小改动),例如语法或词句的修改时,可以忽略“为什么”。类似地,向讨论页面中加入内容或回复已有内容,并不需要重复讨论信息。

注意: 在点击章节标题旁的编辑按钮时,摘要栏中将预先填入/* 章节标题 */这不是一段注释,/**/之间的文本将被转换为到该节的链接。请在其后填写编辑摘要。
提示:

不要一次进行大量的改动[编辑 | 编辑源代码]

执行大的改动时,无论是对条目还是讨论页,最好将其分到多个编辑操作中,比如可根据逻辑步骤一步一步完成。如果有疑问,通过“显示差异”按钮查看diff,看看其它用户能否理解您的编辑变化。例举一些会造成令人困惑的差异的操作:

  • 移动段落的同时编辑了内容。解决方法:移动段落,保存,再次打开进行编辑。
  • 在同一个编辑中改变多个段落的顺序。解决方法:一次仅移动一个段落。
注意: 这个方式会增加最近修改中的日志次数,不必担心,用户可以通过启用“参数设置 > 最近更改 > 高级选项”中的“按页面分组最近更改和监视列表中的更改”进行过滤。

进行页面重排前进行讨论[编辑 | 编辑源代码]

如果您要大规模的修改文章结构或者重写段落,请在讨论页面提前通知,并解释目的和方式。等待一段时间以便其它用户有时间回复和提出自己的看法。

注意,即使经过提前的讨论,仍然需要注意#总是正确使用编辑摘要#不要一次进行大量的改动

最重要的任务[编辑 | 编辑源代码]

接下来,本文将介绍多种可为本维基做贡献的方式。其中最重要的一点是:将您最感兴趣的页面添加到监视列表,并保护它们不受低质量编辑的影响。

ArchWiki 每天都收到来自许多不同用户的大量编辑修改。大部分修改都是实际上的改进,但是一个不小心的修改(哪怕经常出自善意)就可能产生不良后果,包括不准确的信息和内容丢失。如果没有人注意,就会毁掉你和其他用户之前贡献的宝贵内容。这样的编辑其实很容易发生,频率也许超出你的想象,所以 Wiki 维护者和管理员花费了大量时间对这类低质量编辑进行修复。但是您不能完全依赖管理员,因为他们和你一样,能够花在 wiki 中的时间也是有限的,而且您对某些特定领域的了解还会比管理员更专业。所以如果用户只专注于添加新内容,而不注重保护已有内容,您的贡献可能会被破坏,维基也不可能正常工作。

幸运的是,wiki 提供了有用的功能避免此类事情的发生。只需要点击页面顶部的监视链接,就可以将页面加入你的编辑监视列表。这样就可以在监视列表查看改动,或在参数设置页面的电子邮件选项下选择在监视页面发生变动时收到电邮通知。在最近更改页面,监视的页面会被高亮显示。最后,可以在监视首选项中修改设置,包括自动将修改过的页面加入监视列表。

如果发现监视页面的改动有问题,或者不明白为什么被编辑,建议立即修正它,或在相应条目的讨论页面、或编辑作者的讨论页面询问。

参考资料[编辑 | 编辑源代码]

做贡献前,需要了解的内容:

  • 命名规范讨论有效的文章命名策略和原因,以确保它们的可读性和可检索性。创建页面前请先阅读此文。
  • 编辑帮助是一个简短的 ArchWiki 编辑指南。描述了 MediaWiki 的格式语法和 ArchWiki 的相关规范。是 ArchWiki 贡献者的必读文章。
  • 讨论帮助页面说明如何通过讨论页面与其他人交流。
  • 文章样式规范提供了一个 ArchWiki 使用的标准风格指导。
  • 页面分类介绍如何设置页面分类,创建缺失的分类,如何将页面移动到另外的分类。
  • ArchWiki Translation Team (简体中文)有一个创建新翻译的详细步骤,翻译文章时请按照此步骤进行。
  • Help:i18n (简体中文)是 ArchWiki 国际化和本地化的全面指引。
  • Help:Procedures (简体中文)介绍了一些常用的编辑动作。

帮助分类包含了所有的帮助页面。

创建[编辑 | 编辑源代码]

先确保你已经理解了 ArchWiki 的哲学并考虑别人想读什么(参见需求)。正如前面所说,wiki 的范围很广。

请联系管理员获得主要项目的协调帮助。

创建页面包含在主命名空间创建页面的步骤。

Wiki 的子页面功能同样可用于你的用户页。可用于创建空白页面的草稿。注意用户页面不能分类,但其他特性均可用。草稿完成之后,简单地将子页面移动到新的名称下即可。请在移动后再添加条目的相关状态模板。状态模板的理由描述越详尽,就越方便维护维基的用户与你合作。

完善[编辑 | 编辑源代码]

在任何 Wiki 中,内容编辑、完善和更新都是永不停息的持续过程。如果希望提供帮助,请注册一个用户并开始进行:

非 Arch 用户[编辑 | 编辑源代码]

任何人都可以注册一个用户。欢迎非 Arch 用户贡献适用于其他 Linux 发行版或其他操作系统的内容,只要能确定它同样适用于 Arch Linux。需要指出,条目是为 Arch 用户编写的,因此:

  • 不要添加仅仅与其他 Linux 发行版或者操作系统相关的内容。例如,Fedora 用户同样可以为 systemd (简体中文)的页面贡献,但若提及新内容在 Fedora 上工作,后者将视为无关内容而被删除。
  • 不要将 Arch 专有的约定、术语或工具替换为适用于更大范围操作系统的版本。

维护[编辑 | 编辑源代码]

  • 巡查最近更改, 报告和修正有问题的编辑.
  • 为页面打上适当的页面状态模板,例如: 删除{{Remove}}, 过期{{Out of date}}, 待翻译{{Translateme}},不准确{{Accuracy}},归档{{Archive}}
  • 将一些页面加入你的监视列表,以防止文章被低质量更改破坏。这是#最重要的任务
  • 参加讨论页面中的讨论:大部分用户可以通过此链接查看讨论页的最新更改。和维护直接相关的讨论位于[1], [2], [3][4]; 此外 ArchWiki:Requests 也是一个讨论页面。

组织[编辑 | 编辑源代码]

整理、归类和移动页面是所有 Wiki 维护者的主要任务。

翻译[编辑 | 编辑源代码]

简体中文维基是外部 wiki 站点。我们欢迎您帮助翻译 ArchWiki 的其他语种页面到本 wiki 以丰富其内容,但要注意一一对应的翻译不是必须的。请阅读帮助:翻译以开始翻译。

关于 Arch Linux 官方 wiki 的翻译团队,请参见 arch:ArchWiki:Contributing#Translating

头脑风暴[编辑 | 编辑源代码]

为了同其他用户实时协调贡献,可以使用 Arch Linux 官方专用的 #archlinux-wiki IRC 频道。而对于 Arch Linux 中文维基,则可以使用 Telegram 或者 Matrix 群天群组

如果不确定从哪里开始,或者觉得编辑别人的文章很别扭,你也可以在 Arch Linux 论坛论坛和 Wiki 讨论中文论坛中提出主意和建议。

后台维护[编辑 | 编辑源代码]

使用 Arch Linux Bugtracker 贡献修复并完善 MediaWiki 代码。可参阅关于 ArchWiki 后端的已报告的 bug 列表

抱怨[编辑 | 编辑源代码]

是的,只要表达方式合理,即使是普通的抱怨我们也接受,这也是提高 Wiki 的一种方式。有抱怨,请前往 ArchWiki talk:Administrators 页面。当然,应该不用特别说明,请尽可能用文明的和尊重的语气来抱怨一些事 :)

抱怨或评论的所有合适的位置和方法都在页面 ArchWiki:维护团队#使用什么方式联系到责任人中被概述。