在MDN上经常会有一些东西需要加进来和更新。不管是一个全新出彩API的文档或者一个旧API的细微修改,你会找到很多可以出力的机会。关于怎么使用编辑器,和我们为了自动化结构与内容格式使用的宏系统的细节,请参看MDN editor guide。
编辑一个已经存在的页面
如果你找到一个想去修正的页面,简单点击右上方的“编辑”按钮。这会打开一个 WYSIWYG编辑器来帮助你修改页面内容。
有很多原因你会去编辑一个已经存在的页面:
- 你发现一个错误或者错字。
- 你想把某件事重述让人更容易理解。
- 页面的布局或者格式混乱。
- API的文档发生了变化,文档需要相应作出更新。
- 你想要增加一些信息,关于一个API在多个浏览器的性能表现差异。
- 你想要增加或者改进一个代码范例
- 文章是一个存根,或者仅仅丢失了一些重要的细节。
增加一个新页面
这是个大的任务!在MDN上添加一个新的页面会让Web爱上你,拥抱你。这里有一些显而易见的原因,包括给未文档化的API做文档,增加一个新的教程或者做一个主题的指南。
当你登陆后,按以下步骤去创建一个新的页面在MDN上:
- 点击一个 "missing page" 链接
- 当你浏览MDN的时候,你会偶然发现有些链接的页面还不存在。很多时候,当我们创建文章,我们会把需要创建的页面链接加进去,即使它们还没做好。这有助于我们跟踪那些最终需要完成的事,虽然有时候会花一些时间回过去完成它们。你可以随意去做!只要点击这些链接,你会直接进入新网页的编辑器。
- 创建一个子页面
- 在每篇文章的最右上角是“This Page“下拉菜单。菜单里面有”New sub-page“选项。点击这个选项会打开一个页面编辑器,在这个新的页面在站点层次上的父页面是你选择”New sub-page“那个页面。只需填写标题和标签,就可以开始写正文了。
- 创建一个副本
- 你也可以克隆一个已经存在的页面,使用“This page“下拉菜单的”Clone this page“选项。点击该选项会复制当前页面,其父页面和当前页面完全相同。接着页面上会打开编辑器,你就可以设置页面的标题和标签,然后编辑页面的内容。给一个现有站点参考区域增加一个新的页面,通常是一个好的方式。比如,这会给你内容布局的样式。
- 创建一个链接到还没存在的页面,然后点击它
- 这有点儿混合模式。因为每个页面应该被某处链接到,你可以从给一个新的文章创建一个已有页面的链接开始,然后保存页面。你可以点击你刚刚插入的链接,接着在打开的编辑器中写新的文章。
注意:如果你没有登录,当你想要查看未存在的文章时,会跳出404错误提示,而不是跳出新页面的编辑器。
寻找信息
有很多信息没有出现在这里。有时候这些信息你很难搜寻到,但你恰好很需要用到,这里有一些提示来帮助你。
- 模块化所有者列表
- Mozilla的项目在一个“模块所有者”基础上进行;每一个重要的组件都有一个或者多个所有者负责它的进展。这些所有者往往是信息的最好来源--至少是个好的方式找到对的人来讨论。
- Mozilla源交叉参考
- MXR(Mozilla cross-reference的缩写)能让你得到所有Mozilla工程的源代码(有些事例除外,比如Firefox OS是托管在Github上)。代码和有关评论常常是信息的重要资源。
- Mozilla wiki
- The Mozilla wiki(常被称作“wikimo“)是过程和设计的一些笔记,草稿,计划和初步的方案等。尽管看起来一团糟,但也是宝贵的知识库。