2011 年帮助改进 MDN

(如果标题在一年前出现会更酷。好吧。)

在关于 MDN 上的开发者文档的各种讨论中,无论是在 Mozilla 社区内部还是“外部”,我都发现了两个共同的主题。

  • 有些人不知道 MDN 是一个他们可以参与贡献的维基。
  • 许多人认为编写文档非常困难。

让我现在澄清这些误解。

  • 是的,MDN 是一个维基!我们在前端有一些静态的登陆页面,但除此之外,它就是一个维基。您可以编辑它(提示:查找“编辑”按钮)——如果您能这样做,我们将不胜感激。
  • 我可能会有偏见,但我认为写作很容易——难的是知道要写什么。如果您对某个主题了解得足够多,可以与朋友谈论它,那么您就可以写下它。不要担心语法和拼写是否完美,或者组织是否可以更好。其他人可以帮助解决这些问题。但是,请、请分享您的知识。
  • 如果您处于学习模式,您仍然可以为改进 MDN 做出贡献。您可以通过以下方式提供帮助:
    • 更正错别字或不准确之处
    • 润色不清楚的措辞
    • 随着软件的演变更新信息
    • 重构部分内容以改善流程
    • 添加示例

    所有这些都是无需成为该主题专家或从头开始编写大量内容即可改进内容的方式。

MDN 上的文档是由一个社区创建和维护的,社区成员根据自己的技能、知识、可用性和兴趣做出不同程度的贡献。我们邀请您加入我们。

我们正在通过几种方式将这个社区聚集在一起。

  • 我们每两周在星期三通过 IRC 举行 MDN 社区会议。
  • 我们在 2011 年每个季度举行一次文档冲刺。到目前为止,我们已安排了 1 月和 6 月的冲刺。

有一个用于 MDN 相关事件的 Google 日历。您可以订阅该 Feed使用 iCal 应用程序访问它在 Web 浏览器中查看它

MDN 社区会议

我们在 irc.mozilla.org 上的 #devmo 频道中每隔一周三的 18:00 UTC(美国太平洋时间上午 10:00)举行 MDN 社区会议。下一次会议将于 2011 年 1 月 19 日举行。您可以在 MDN 社区会议维基页面 上找到每个会议的页面(事先的议程和事后的记录)。

全球 MDN 文档冲刺

基于 2010 年 10 月在巴黎举行的 MDN 文档冲刺 的成功,我们期待着在 2011 年每个季度举行大约一次文档冲刺,交替进行虚拟(全部在线)冲刺和面对面冲刺。

新年的第一次文档冲刺将是虚拟的。

  • 开始时间:2011 年 1 月 28 日星期五 14:00 UTC(美国太平洋时间上午 6:00)
  • 结束时间:2011 年 1 月 29 日星期六 23:59 UTC(或美国太平洋时间下午 4:00)

冲刺期间的协调将在 irc.mozilla.org 上的 #devmo 频道中进行。西班牙本地化团队对同时进行 MDN 翻译冲刺表示了一些兴趣。任何其他翻译人员也欢迎!

有关详细信息(随着其发展),以及注册,请访问 Mozilla 维基上的 1 月冲刺计划页面。作为一个小小的激励,如果您在 1 月份的冲刺中积极参与,并提供联系方式,我将确保您获得印有 MDN 徽标的 T 恤。您也可以通过电子邮件向我提出问题(jswisher at mozilla dot com)。

Open Help 大会上的 MDN 文档冲刺

此次文档冲刺将于 2011 年 6 月 6 日至 8 日在俄亥俄州辛辛那提举行,紧随 Open Help 大会 之后(该大会由 Gnome 文档团队的 Shaun McCance 组织)。我将在详细信息开发出来后分享更多内容。

想要帮忙吗?

您无需等待文档冲刺即可为 MDN 做出贡献。您可以创建账户 并随时参与。无论您是想撰写新文章,还是仅仅更正您注意到的错别字,所有建设性贡献都受欢迎。

关于 MDN 的公告和异步讨论发生在 dev-mdc 上,可以作为邮件列表Usenet 新闻组Google 群组 访问。

#devmo 频道不仅仅用于会议和文档冲刺!您可以随时加入其中,与 MDN 编写社区的其他成员聊天。我们期待尽快收到您的来信。


3 条评论

  1. Dan

    说实话,我不想再在另一个网站上设置另一个账户了。因人而异。

    2011 年 1 月 11 日 上午 11:42

  2. stanley.tweedle

    我发现这篇文章与我尝试为资源内容做出贡献之间存在某种巧合。出于此目的创建了合适的用户帐户后,我在使用该帐户时遇到了困难。我怀疑我尝试做出贡献的经历可能是由于资源本身的过渡状态(我认为我们过去称之为“DMO”)。Mozilla.org/Mozilla.com 网站(例如子域名、seamonkey-projects.org)的美学发生了变化——据我回忆,估计在过去 3 年中不止一次。是否有可能登录问题最近才得到解决?是否有其他用户最近才发现了原本放置错误的登录凭据?

    在我访问那些在样式上有所不同或结构/逻辑/超链接大纲发生变化的 Mozilla 节点时,我记得自己通常会感到困惑(比喻地说“迷路了”……呵呵),因为我/期望/获取的内容与我最终在这些位置/实际/获取的内容之间存在差异。

    示例(更改可能令人困惑):今天,当我的登录在 https://mdn.org.cn 处获得授权时,我感到惊讶。
    那里的一些明显变化包括头像/图标,其中包含旧的 Mozilla/'saurus'/在“MDN”文本之上。该 URL 经常被引用为“DMO”或“the DMO”。

    我意识到,要相信用户仅仅因为一些图形/样式更改而对其浏览器位置如此困惑,这需要怎样的理解。这很难相信,不是吗?我承认,我不记得自己完全迷路了——以至于完全到达了错误的 URL——但是,在使用我的有效用户 ID(今天登录时已验证)未能获得授权的情况下,我得出以下结论:
    1.) 从正确的“MDN”用户身份验证位置,我输入的凭据无效;
    2.) 位置并非我所认为的那样。那里提供的用户登录不包括 developer.mozilla.org 授权的用户 ID。

    2011 年 1 月 14 日 下午 20:02

  3. Janet Swisher

    stanley.tweedle

    对于 developer.mozilla.org 网站的视觉重新设计似乎让您感到困惑,我深感抱歉。此重新设计已经实施了几个月了。该网站使用与过去几年(自迁移到 DekiWiki 以来)相同的登录凭据。您可能最终进入了论坛的登录屏幕,这要求您单独登录,而不是登录维基。但是,维基和论坛使用相同的凭据。如果您仍然无法登录,请随时在 #devmo 或 dev-mdc 中寻求帮助(请参阅上述详细信息)。

    2011 年 1 月 18 日 下午 17:25

本文的评论已关闭。