Mozilla Hacks

欢迎新成员：Web Platform Docs

Avatar photo 由

发布于 2012 年 10 月 8 日 在 Docs，MDN，Mozilla，News 和 Web Developers

为开放的 Web 和 Web 标准编写文档是一项艰巨的任务！作为 Mozilla 人员，我们对此非常清楚 - 为开放的 Web 编写文档多年来一直是 Mozilla 开发者网络 的使命。我们能为促进自由和开放的 Web 做的任何事情都是有意义的。在设计和开发新的 Web 标准中，有许多不同的群体参与，因此可能很难确定目前使用它们的方法。这就是我们很高兴能够与您分享此消息的原因。

介绍 Web Platform Docs

Mozilla 与由万维网联盟 (W3C) 召集的一组主要 Web 相关组织一起，宣布开始 Web Platform Docs (WPD)，一个新的 Web 标准文档网站，该网站将采用开放许可并由社区维护。支持组织（称为“管理者”）从其现有资源中贡献了一批初始内容到该网站。内容主体处于 alpha 状态，因为还有很多工作要做，才能集成、改进和增强这些内容，以实现 WPD 作为 Web 开发人员文档的全面且权威来源的愿景。管理者希望尽早开放该网站以供社区参与。有了您的帮助，WPD 可以实现其愿景，成为 Web 开发人员文档的全面且权威来源。

Web Platform Docs 与 MDN 的目标类似：帮助 Web 开发人员提高他们使用 Web 标准构建网站和应用程序的能力。Mozilla 欢迎这项努力，并与其他管理者一起在资金上支持 Web Platform Docs 项目，并为其提供种子内容。这个新项目非常符合 Mozilla 在 Web 上促进开放性、创新和机会的使命。

这对 MDN 意味着什么？

MDN 已经为 Web 开发人员以及使用或贡献 Mozilla 技术的开发人员提供了大量信息。这不会改变。MDN 社区的一些成员，包括付费人员和志愿者，都积极参与了 Web Platform Docs 项目。Web Platform Docs 结合了一些来自 MDN 的种子内容，即教程和指南内容。任何人都可以在其 知识共享署名-相同方式共享许可 (CC-BY-SA) 下使用 MDN 内容，无论是在 WPD 上还是在其他地方。

许可问题

许可证是事情变得有点复杂的地方。MDN 和 WPD 对重新使用使用不同的贡献者协议和不同的许可证。默认情况下，WPD 贡献者授予 W3C 在开放许可证（知识共享署名 (CC-BY)）下重新许可其原始内容的能力。MDN 内容由贡献者在 CC-BY-SA 下许可。版权归贡献者所有，而不是 Mozilla 所有，因此我们无权更改许可证。因此，来自 MDN 的内容在 WPD 上出现时必须特别标记和归属。如果您在 WPD 上创建一个帐户并创建一个新页面，您将看到有一个选项可以表明您正在贡献的内容来自 MDN，以及在 MDN 上提供原始 URL。如果您确实复制了 MDN 内容（我们很乐意您这样做），我们要求您遵守许可证要求。在 WPD 上还有一种方法可以将文章中的部分标记为来自 MDN，用于将它们合并到 CC-BY 内容中的情况。

参与进来

我们鼓励所有 Mozilla 人员访问 Web Platform Docs 网站，看看，并参与其中。通过与其他管理者合作，共同构建一套完整、简洁、准确的 Web 标准文档，我们可以帮助让万维网的未来比以往更加光明！

15条评论

  1. Schalk Neethling

    这个真是太棒了，终于要发布了。从一开始，当它还只是一个 W3C 上相当丑陋的维基时，我就参与其中。虽然它仍然是一个维基，但已经投入了大量精力，使它成为一种视觉和精神上令人振奋的体验。

    每个人都应该参与并贡献这里，我希望这种资源能够让更多人制作网络上的内容。

    2012 年 10 月 8 日 上午 08:48

    1. Janet Swisher

      感谢您的支持！

      2012 年 10 月 8 日 上午 10:39

  2. Julian Viereck

    如果我写了一些关于 WebAPI 的新文档，我应该只在 WPD 上写，只在 MDN 上写，还是两个都写？只要有某种机制来保持文档同步，在两个不同的地方放置相同的文档就不是问题。

    鉴于许可证的不兼容性，这可能会导致问题，因为对 MDN 在 CC-BY-SA 下进行的更改无法合并到 CC-BY 中。

    2012 年 10 月 8 日 上午 10:47

    1. Janet Swisher

      目前没有自动的方式在两个网站之间保持文档同步。这在将来可能会改变，但目前还没有具体的计划。这意味着任何同步都必须手动完成。我当然理解，如果贡献者选择只在一个网站或另一个网站上工作，而不是更新两次。

      WPD 允许对来自 MDN 和类似来源的 CC-BY-SA 内容进行例外（其中“类似”是指高质量的内容主体，其中没有一个版权所有者可以贡献它）。CC-BY-SA 内容必须特别标记，如本文所述。

      最终，您在哪里贡献由您决定。WPD 重新使用许可证限制较少，但 贡献者协议 授予网站托管者比 MDN 更大的权利。这取决于您对什么感到满意。

      2012 年 10 月 9 日 上午 08:57

  3. HTeuMeuLeu

    句子“这个新项目非常符合 Mozilla 在 Web 上促进开放性、创新和机会的使命”在同一段中出现了两次。

    无论如何：干得好，并且非常棒的举措！

    2012 年 10 月 8 日 下午 12:28

    1. Janet Swisher

      它非常重要，所以我们说了两次！现在已修复。谢谢。

      2012 年 10 月 8 日 下午 12:31

  4. David Mulder

    http://validator.w3.org/check?uri=http%3A%2F%2Fwww1.webplatform.org%2F&charset=%28detect+automatically%29&doctype=Inline&group=0

    嘿嘿，已经说得很清楚了 :P

    但说真的，为什么一开始你不从 Mozilla 导入几乎所有内容呢？以及从其他各自的网站添加内容？

    2012 年 10 月 8 日 下午 13:14

  5. Jay Patel

    我很高兴看到它实现。祝贺所有从早期就开始参与这个项目的人。它将是一个很棒的资源，我确信会有很多 MDN 贡献的内容。:-)

    2012 年 10 月 9 日 上午 00:34

  6. Karel Jára

    我在页面上没有找到任何本地化功能。它（是否）已实施？与 MDN 相比，这将是一个严重的倒退，不是吗。

    2012 年 10 月 9 日 上午 03:40

    1. Schalk Neethling

      嘿 Karel，

      是的，目前没有本地化支持，但正在进行中，很快就会推出。

      2012 年 10 月 9 日 上午 05:58

  7. Jerzy

    为什么创建 MDN 的克隆而不是扩展它？MDN 难道不是维基吗？

    2012 年 10 月 9 日 下午 12:49

    1. Janet Swisher

      是的，它们都是维基，但它们不是克隆。WPD 拥有来自比 MDN 范围更广的组织的支持和内容。（尽管我们非常感谢 Google 在过去几年中对 MDN 的贡献。）

      MDN 仍然存在，我们计划继续改进它，包括功能、内容和更新过程。

      2012 年 10 月 9 日 下午 14:29

  8. Ken Saunders

    嗨，各位，

    我很高兴也很激动地看到它。它非常 Mozilla 风格。恭喜。

    我昨天在网站上花了一些时间，虽然我知道它处于 alpha 阶段，但有一些基本问题（一些与可访问性、样式等相关），这些问题应该与其他问题一起解决，我还在注册时遇到一个问题。
    目前似乎没有针对该网站的任何类型的错误报告和管理系统。
    有没有，或者将来会提供吗？

    我唯一的选择是在可能不太准确的论坛中发布这些问题，并以提问的形式写出来，这样亚历克斯·特雷贝克就不会生气了。:)

    这些问题由其他网站成员回答，如果答案来自有权威的人，或者来自提供准确和/或有用答案的人，而不是试图获得积分的成员，那就没问题了。

    当时间允许时，我将很乐意作为 Mozilla 和开放网络的支持者做出贡献，所以请告知我如何做到这一点。

    2012 年 10 月 9 日 下午 13:56

    1. Janet Swisher

      新网站的错误在 W3C 的 Bugzilla 中跟踪（当我输入时它正在维护中，但很快就会恢复）。到错误追踪器的链接正在添加到更显眼的地方，以及到 讨论邮件列表 的链接。还有一个 IRC 频道（irc.freenode.org 上的 #webplatform），但目前有点嘈杂。

      2012 年 10 月 9 日 下午 14:05

  9. Ken Saunders

    感谢 Janet。

    2012 年 10 月 9 日 下午 14:30

本文的评论已关闭。