写作内容

在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“)是过程和设计的一些笔记,草稿,计划和初步的方案等。尽管看起来一团糟,但也是宝贵的知识库。

文档标签和贡献者

标签: 
 此页面的贡献者: cehnjing, ziyunfei
 最后编辑者: cehnjing,