MDN 和 Web Platform Docs 如何协调

自从 Web 平台文档 (WPD) 发布以来,我们收到了很多关于它与 Mozilla 开发者网络 (MDN) 如何协调的问题。例如,内容如何在两个站点之间共享,如何跟踪更改,谁将负责移植内容,以及人们应该向哪个站点贡献内容。为了帮助回答其中的一些问题,我们整理了这份简短的常见问题解答。

在我们深入探讨这些问题之前,值得强调的是,Mozilla 认为 MDN 和 WPD 相互补充。虽然 WPD 刚刚开始它的旅程,旨在成为开发人员宝贵的资源,但 MDN 已完全成熟,并将继续满足 WPD 不能满足的需求。我们还希望借此机会提醒大家,Mozilla 是一个社区驱动的组织,因此我们对任何更改的决定都将基于社区反馈。

以下是我们关于 WPD 推出后收到的主要问题。如果您还有其他问题,请在下方评论或发送邮件至 jswisher (at) mozilla (dot) com。

MDN 和 WPD 似乎有类似的目标。它们有什么不同?

Mozilla 支持 WPD,因为它符合 Mozilla 推动 Web 开放和创新的使命。WPD 得益于来自多个浏览器供应商和 Web 相关公司的资金支持、内容贡献和观点。MDN 长期以来一直支持各种类型的开发人员:Web 开发人员、使用 Mozilla 代码的开发人员以及在 Mozilla 代码上工作的开发人员。MDN 通过为所有这些受众服务来促进 Mozilla 的使命。

一个区别在于这两个站点内容重用时的默认许可证,尽管它们都是 Creative Commons 许可证。MDN 使用 CC-BY-SA 许可证,确保重用内容始终在开放许可作品的背景下发布。WPD 使用 CC-BY 许可证,这使得内容可以尽可能广泛地重用,包括在其他专有作品的背景下。

为什么支持两个类似的站点?它们之间不是有很多主题重叠吗?

WPD 尚处于起步阶段,需要时间积累势头,解决初期问题,并培养社区,Mozilla 和其他 WPD 管理者将帮助实现这些目标。与此同时,MDN 需要支持每周访问它的数十万开发人员。

随着 WPD 的成熟,MDN 社区将评估是否以及何时在特定主题上转而使用 WPD。在理想的未来,WPD 将成为 Web 标准的权威资源,拥有庞大的志愿者社区和基于社区的治理,而 MDN 可以专注于 Mozilla 的愿景及其实现这些标准的开源产品。但这需要一些时间才能实现。

WPD 以“最小可行产品”的形式发布了它的网站,只提供了足够的特性来开始使用。这是一个谨慎而合理的策略,这样反馈可以帮助确定网站的开发方向。然而,这意味着 WPD 目前缺少一些之后会添加的理想特性。其中最重要的是对将文章翻译成其他语言的支持,以帮助母语不是英语的 Web 开发人员。

与此同时,由于 MDN 作为 Web 资源有着悠久的历史,它提供了多种语言的翻译,这些翻译是由全球志愿者本地化社区创建的,他们根据当地的需求和兴趣对主题的翻译进行优先级排序。与英文内容一样,本地化社区将评估是否以及何时将翻译工作转交给 WPD 的内容。

MDN 内容可以复制到 WPD 吗?谁将负责将 MDN 内容移植到 WPD?

任何在 WPD 上处理特定主题文章的人员都非常欢迎将 MDN 中的内容纳入,因为这样做是有意义的。我们希望,与其将 MDN 内容整体导出到 WPD,不如由 WPD 作者将内容整理到新网站上的适当位置。

请确保遵循 在 WebPlatform.org 上使用 MDN 内容的许可和署名指南。这是必要的,因为两个站点的许可证不同;MDN 内容在 WPD 上必须被区分和署名,以确保对 MDN 作者的正确归属,并传达共享许可的要求。

两个站点中的重复内容是否会自动保持同步?

目前没有技术解决方案可以实现这一点。我们预计每个站点的內容将独立发展。

难道这意味着要保持两个站点更新都需要重复工作,尤其是在浏览器和标准不断发展的情况下?

是的,不幸的是。最终可能有一些领域可以让两个站点共享信息,例如浏览器兼容性数据。[1] 这还有待解决。

管理者只是将 WPD 交给“社区”还是分配了人员来维护它?

除了在 MDN 上工作外,Mozilla 还安排了付费人员参与 WPD 社区。Opera 的 Chris Mills 作为 W3C 研究员,将一半时间专注于 WPD。其他管理者以及 W3C 也安排了人员在 WPD 上工作;您需要询问他们关于时间分配情况。然而,来自非管理者付费人员的 Web 开发人员、作家、教育工作者和其他人员的贡献对于 WPD(以及 MDN)的长期成功至关重要。如果只有管理者付费人员做出贡献,它将无法实现成为真正开放的社区资源的愿景。

我想为 Web 标准文档做出贡献。我应该为 MDN 还是 WPD 做出贡献?

这两个站点都需要您的帮助,Mozilla 正在为两个站点做出贡献。MDN 拥有一个成熟的社区,并为 Web 提供了大量开放的文档,这些文档始终需要改进、扩展和翻译。我们将继续建设这个社区,为他们提供学习和分享 Web 知识的地方。WPD 的社区仍在形成中,需要您在信息架构和翻译方案等基本问题上的输入。WPD 旨在汇集来自不同组织的教程和材料,以及来自 Web 开发人员的贡献,我们相信这也有助于开放 Web。查看这两个站点。结识社区。加入您感觉舒适的地方。

以下是一些参与的渠道

  Mozilla 开发者网络 Web 平台文档
贡献介绍 入门 入门指南
邮件列表 dev-mdc@lists.mozilla.org public-webplatform@w3.org
IRC 频道

#devmo on irc.mozilla.org #webplatform on irc.freenode.org

[1] 具体来说,MDN 收集了大量手动收集的跨浏览器兼容性数据,WPD 可以立即使用这些数据;WPD 正在研究自动化收集这些数据的方法,MDN 也可以使用这些方法。


13 条评论

  1. Bob Pelerson

    “MDN 使用 CC-BY-SA 许可证,确保重用内容始终在开放许可作品的背景下发布。WPD 使用 CC-BY 许可证,这使得内容可以尽可能广泛地重用,包括在其他专有作品的背景下。”

    这是一个虚假的说法,不应该被传播。根据 CC-BY 许可证发布的内容将始终在开放许可证下可用,无论谁出于何种目的使用它。这就是该许可证的意义所在。根据 CC-BY-SA 许可证发布的内容将可用,但在某些使用上受到限制。特别是,它会导致人们不太愿意添加额外的内容。

    重要的是,永远不要声称或假装 CC-BY 可以成为非开源或非自由的。这完全不正确。

    2012 年 12 月 18 日 下午 09:59

    1. Janet Swisher

      感谢您的反馈,Bob。您是否同意“CC-BY-SA 确保重用内容始终在开放许可作品的背景下发布”这一说法?我可以更新这篇文章。

      2012 年 12 月 18 日 下午 10:08

      1. Bob Pelerson

        是的,这是一个准确的说法。

        2012 年 12 月 18 日 下午 10:17

        1. Janet Swisher

          我已经更新了这篇文章中的这一部分。

          2012 年 12 月 18 日 下午 10:26

  2. Anders

    MDN 和 WPD 的既定目标确实很相似。如果 Mozilla 真正支持 WPD,那么共享主题的内容(即 Web 标准,而不是 Mozilla 技术)将从 MDN 中移出。拥有重复或共享内容毫无意义,并且会损害 Web(或者至少会损害 WPD 的努力)。

    > 最重要的是对将文章翻译成其他语言的支持,以帮助母语不是英语的 Web 开发人员。

    翻译开发者文档可能是一个很好的方法,可以团结翻译人员并创建一个围绕他们的社区。但是无论好坏,英语都是网络,尤其是开发者的通用语言,所以这对开发者来说充其量是没有好处的,甚至可能是一种不利,因为翻译后的部分可能不完整或过时,导致信息不完整和陈旧,翻译后的页面可能会在搜索结果中显示为噪音。所以翻译功能不应该阻碍内容的回滚。

    2012年12月18日 下午1:34

    1. Janet Swisher

      您好 Anders,感谢您的评论。

      英语可能是网络的通用语言,但这并不意味着每个人都能同样流利地阅读它。一些网页开发者是自学的,没有大学教育,或者是在英语不占主导地位的大学接受教育。例如,我从一些非英语母语的 Mozilla 社区成员那里听说,他们可以用英语参考文档,但对于概念性文档或教程,他们的母语更舒适。当然,对于志愿者翻译来说,存在翻译可能过时的风险,尤其是如果一些关键人物退出的话。我们对 MDN 的增强积压包括帮助翻译人员跟踪需要更新的内容的工具,我们希望在 2013 年实施这些工具。

      正如您所说,翻译与英语内容的处理方式是正交的。这篇文章的部分目的是从我们的网页开发者受众那里了解一下情绪。

      2012年12月18日 下午7:08

本文的评论已关闭。