维基贡献指南
下面的准则将有助于保持wiki的一致性,对于新手通俗易懂,同时便于偶然贡献者编辑。
某些情况下可能有例外情况,除非您有一个充分的理由。
准则
- 文章必须易于阅读和编辑,越简单越好:应仅使用编辑器 GUI 中的基本功能对文章进行格式化,并在必要时加上代码标记和表格结构。
为什么?更高级的格式可以让维基看起来更“专业”一些,但是对于临时用户和贡献者来说,阅读和编辑也更困难。 使用标签和按钮的更高级布局可以让页面更加紧凑,但这通常比只提供一个操作列表和可供读者滚动和点击的链接这样的简洁布局更容易让人头疼。除此之外,一个简单的非交互式布局可以方便的打印。 工厂安装:首次在设备上安装 这个教程就是一个很好的范例。
- 避免在维基中出现重复信息 :关于同一主题的信息只能在维基上出现 一次 。如果需要在其他地方显示相同的内容,我们建议使用超链接!
比如,如果您编写教程的其中一个步骤是“配置 USB 存储器”,您应该链接到 使用存储设备,不要在新的教程中写下或复制粘贴相同的步骤!
- 避免重复上游文件 : 考虑提供文档的更通用的部分 上游 , 并链接到您的文章中。例如,这个维基就存在于 OpenWrt 相关的文档中 IPv4 的配置。一些上游 wiki 示例:Linux WiFi 驱动维基,OpenVPN 维基 等等。不是所有的人都使用维基,也不是都接受第三方的贡献。 如果上级的贡献无法获得的,那么在 OpenWrt wiki 中获得这些信息也是很好的。
- 版本信息 : 文章中的信息应该是针对 目前的稳定版本 有效的 。旧版本相关的信息应被标记为这样: 仅适用于较旧版本或快照版本(不推荐使用或非常新功能)。
- 文章应该很容易找到 大多数人会用他们选择的搜索引擎搜索信息,或者用 wiki 自己的内部搜索。 使用简短的描述性标题和介绍,其中包含正确的关键字。 你可以尝试用你最喜欢的搜索引擎来搜索你的文章(几天后再搜索你发布文章,因为搜索引擎需要时间来更新他们的索引)。 如果你不能找到自己的内容,其他人可能也不会那么容易找到!
比如:installing.opkg.packages.in.mount.point.other.than.root 是一个很长的标题,可以用 opkg -- Installation Destinations 来代替,但是当没有人浏览 wiki 时,后者不会像第一个那样容易找到,而是使用搜索引擎。
- 文章应该解释他们为什么存在,他们的目的是什么。 请在说明您正在配置的功能的情况下添加“介绍”一段或两段,并按照说明来满足需求。 它不需要非常冗长。 例如,这里的第一段: 使用固件生成器(ImageBuilder)
- 你写的所有教程都必须亲自测试,否则必须警告 声明该教程没有经过测试(并且在成功测试的时候去掉警告)。
- 每篇文章有一个主题。文章应该集中在单一的,重点突出的主题上,例如“安装和配置 Adblock ”。 涵盖许多不同主题的一般文章,例如“过滤网页流量”(其中谈论 Adblock、代理服务器,也可能是 Tor 和 VPN)应该分开。
- 大篇幅的教程应该分开。每个步骤很长的大型教程应该分成不同的文章,每个文章都包含一部分步骤。 如果教程包含条件步骤或可选步骤(例如:“如果执行步骤 A ,那么您可以执行 B 或 C ,然后执行 D “)。 例如 工厂模式安装:首次在设备上安装 或者 "Hello, world!" 在 OpenWrt 编写第一个程序
- 文章应该可以从维基内访问 如果是某种教程,请确保您的文章在其中一个主要类别页面(下面的链接)中有链接。 如果某些文章是多篇文章教程的一部分,则可能不需要这篇文章在类别页面有链接,但要确保所有文章都可以从主要类别页面或多篇文章教程的其他页面中获得。 非常受欢迎的文章也可以链接到其他教程,如解释 避免重复信息在此维基百科上面 的口头禅。 点击右侧工具面板上的“链”图标(位于 时钟 图标下方),就可以方便的获取当前页面的链接。