MDN 收录规则

MDN Web 文档的内容是通用的，并不偏向某一个浏览器。这使得 Web 开发人员可以编写与任何浏览器都兼容的代码。本文介绍了在 MDN Web 文档上应该包含哪些主题或类型的内容的有关信息。

编辑准则

本节描述了 Mozilla MDN 员工为管理 MDN Web 文档上的内容而设置的准则。MDN Web 文档的所有贡献者都应遵守这些政策。

MDN Web 文档上的所有内容都必须与其出现的技术相关。网站绝不会接受垃圾信息（商业广告）和其他不相关的内容。继续尝试提交垃圾信息的贡献者可能会被 Mozilla MDN 工作人员酌情禁止访问 MDN。

与主题相关的商业网站的站外链接将根据具体情况进行判断。它们在帮助 Web 开发人员方面的价值必须超过其商业利益价值。

MDN Web 文档上的文章必须保持中立的观点，在没有编辑偏见的情况下报告浏览器的变化。不接受对任何浏览器或用户代理的贬损评论。

MDN Web 文档上记录的 Web 技术应该朝着标准方向发展，并且必须至少有一个渲染引擎实现了它。浏览器支持的变化会记录在文章的浏览器兼容性部分。

如果你想为 MDN Web 文档提供内容建议，请务必在提交之前阅读此页面以确保你的建议是合适的。

对于新的参考页面或指南，请在我们的社区存储库上进行讨论，概述你建议的内容和原因（请尽可能明确）。

如建议涉及新内容的大型项目，请参阅包含页面的标准，该页面简述了申请流程。

一般来说，如果它是一种开放的 Web 技术，我们会在 MDN Web 文档上对其进行记录。这意味着我们的内容涵盖 Web 开发人员在创建站点和应用程序时可以使用的任何技术。

如果多个浏览器实现了该功能，并且它是一项标准，或者正在朝着标准化发展，那么我们肯定可以收录它。如果它仍然处在实验阶段，没有在多个浏览器中实现，可能会发生一些变化，那么它仍然适合被收录，但可能不会被视为文档的写作团队优先事项。

换句话说，要在 MDN Web 文档上记录的 Web 技术应该满足以下条件：

我们主要关注前端 Web 技术：

我们还记录了一些更广泛的主题，例如 SVG、XML、WebAssembly 和无障碍。此外，我们还为这些技术提供了广泛的学习指南，还有相关的术语表。

备注： 后端技术通常在其他地方有自己的文档，MDN 不会试图取代这些文档，尽管我们确实有一些例外。

MDN Web 文档上的所有内容都必须与其出现的技术部分相关。贡献者应遵循这些 MDN 的编写风格、代码示例以及一些其他主题的撰写指南。

有关技术是否可以记录在 MDN Web 文档上的标准的更多详细信息，请参阅包含页面的标准。

在 MDN Web 文档上，我们一直在努力寻找合适的文档记录新的 Web 标准技术。我们力求在尽早发布文档以便开发人员可以及时了解新功能，同时也需要在足够晚的时间发布文档以取得平衡，使技术成熟稳定，从而文档不需要频繁更新或快速地被移除。

一般来说，我们通常将记录新技术的最早时间定义为：当该技术功能已被确定并已在某处实施，被视为在朝着标准化方向发展的时候。

我们考虑记录一项新技术，如果它是：

文档规范必须由可靠的标准组织（例如 W3C、WHATWG、Khronos、IETF 等）发布，并且已经达到了合理的稳定水平（例如 W3C 的工作草案或候选推荐阶段，或者根据针对该规范提出的问题的流动情况来判断规范已经相对稳定）。
至少一个浏览器中已经始终如一地实现了该规范，并且其他浏览器开发者也表现出了兴趣（例如，已经存在一个有效的工单或“意图实现”流程正在进行中）。

如果出现以下情况，我们不会记录新技术：

它没有规范，或者规范只是一个粗略的说明，看起来很容易改变。
目前仅有一个甚至没有浏览器已经实现该规范，且其他未支持该规范的浏览器没有表现出有意实现的迹象。你可以通过询问那些负责开发浏览器的工程师，并查看浏览器的错误跟踪器和邮件列表等方式来评估这一情况。
这项技术在 Web 上不是公开的，或是完全专有的。
已经显示出被弃用或被类似特性替代的迹象。