diff options
author | PocketZ <45301505+pocketdr@users.noreply.github.com> | 2021-05-14 13:22:42 +0800 |
---|---|---|
committer | GitHub <noreply@github.com> | 2021-05-14 13:22:42 +0800 |
commit | b2ff531b8ac397f6d65767d96a241a5f67665948 (patch) | |
tree | 40c97aa08c04a35b41a192ca901979d1b6bb0f54 /files | |
parent | f98e9148137cefc7508b226990516c9e7619f560 (diff) | |
download | translated-content-b2ff531b8ac397f6d65767d96a241a5f67665948.tar.gz translated-content-b2ff531b8ac397f6d65767d96a241a5f67665948.tar.bz2 translated-content-b2ff531b8ac397f6d65767d96a241a5f67665948.zip |
Update MDN/Contribute/Getting_started, zh-CN (#855)
Diffstat (limited to 'files')
-rw-r--r-- | files/zh-cn/mdn/contribute/getting_started/index.html | 119 |
1 files changed, 23 insertions, 96 deletions
diff --git a/files/zh-cn/mdn/contribute/getting_started/index.html b/files/zh-cn/mdn/contribute/getting_started/index.html index 76ae0b45db..e1d71a6f5a 100644 --- a/files/zh-cn/mdn/contribute/getting_started/index.html +++ b/files/zh-cn/mdn/contribute/getting_started/index.html @@ -10,120 +10,47 @@ translation_of: MDN/Contribute/Getting_started --- <div>{{MDNSidebar}}{{IncludeSubnav("/zh-CN/docs/MDN")}}</div> -<p id="What_is_MDN.3F"><span class="seoSummary">我们是一个由开发者和作者组成的开源社区,目的是为了建设一个更美好的网络,不论品牌、浏览器或平台。任何人都可以参与,每个人的贡献都会让我们更强大。我们可以一起继续推动 Web 创新服务于更广泛的利益。我们和你一起在这里开始。</span></p> +<p id="What_is_MDN.3F"><span class="seoSummary">我们是一个开放包容的开发者社区群体,目标是为更美好的互联网提供资源,无关浏览器或平台。任何人都可以参与到我们中来,你的每一分贡献都会让我们更强大。与我们一起,持续推动互联网技术向更伟大的方向革新——就在这里,与你一起。</span></p> -<p>MDN 的每一个部分(文档,演示,和网站本身)都是由一个开放的开发者社区创建的。任何人都可以贡献自己的力量,请加入我们吧!</p> +<p>MDN 的所有内容(文档、示例以及网站本身)都是由这个开放包容的开发者社区群体创建的。任何人都可以贡献自己的力量,请加入我们吧!</p> -<h2 id="简单三步参与_MDN">简单三步参与 MDN</h2> +<h2 id="4_simple_steps_to_MDN">参与 MDN 的四个简单步骤</h2> -<p>MDN(<em>Mozilla Developer Network</em>)是一个 wiki,这意味着<strong>任何人</strong>都可以向其添加和编辑内容。你不一定非得是一个程序员,或了解许多涉及技术方面的知识,才能参与进来。这里有很多任务,从简单的(如校对和纠正拼写)到复杂的(如撰写 API 文档),都等待着我们去完成。</p> +<p>MDN(Mozilla Developer Network)是一个开源的资料库,这意味着<strong>任何人</strong>都可以向其贡献内容。你不一定非得是一个程序员,或者了解许多涉及技术方面的知识。这里有很多可以参与的事情,例如校对、纠正拼写等简单的任务,当然也有撰写 API 文档等复杂的任务。</p> -<p>做贡献很容易,也没有什么风险。即使你犯了一个错误,别人也能很容易更正它。即使你不知道该做什么,或者你的语法不是很好,别担心!我们有一个团队,这个团队的工作就是使 MDN 的内容尽善尽美。总会有人来再看一眼,确保你的文档是整洁且符合标准的。所以,请在此分享你的知识,发挥你的所长,在大家的共同努力下,MDN 只会越来越好。</p> +<p>为开源项目做贡献不是什么难事,即使你出了错,其他人也很容易改正。或许你语法不是很好,那也没什么问题!我们有一个团队,工作就是为了使 MDN 的内容尽善尽美。总会有人来确保你的文档是整洁且符合标准的。所以,请在此分享你的知识,发挥你的所长。</p> -<h3 id="步骤_1:创建一个_MDN_账号">步骤 1:创建一个 MDN 账号</h3> +<h3 id="step_1_create_a_github_account">第一步:创建一个 GitHub 账号</h3> -<p>在开始给 MDN 贡献自己的知识前,你需要有一个 MDN 帐号。详细信息请参阅<a href="/zh-CN/docs/MDN/Contribute/Howto/Create_an_MDN_account">如何创建一个帐户</a>。</p> +<p>在开始贡献自己的力量之前,你需要拥有一个 GitHub 帐号,如果没有,你可以<a href="https://github.com/join">通过这个链接</a>创建一个。</p> -<h3 id="步骤_2:选择一个任务">步骤 2:选择一个任务</h3> +<h3 id="step_2_pick_a_task_to_complete">第二步:选择一个任务</h3> -<p>现在你已经登录,在{{anch("可选的任务类型", "下面的列表")}}里阅读有关不同任务的描述,并决定哪一个任务是最吸引你的。你可以选择任何你喜欢的任务并开始贡献你的知识。</p> +<p>在这之后,在<a href="/zh-CN/docs/MDN/Contribute">任务列表</a>里可以获得有关不同任务的描述,看看哪个任务是最吸引你的。你可以选择任何你喜欢的任务。</p> -<h3 id="步骤_3:做任务">步骤 3:做任务</h3> +<h3 id="step_3_do_the_task">第三步:试着完成它</h3> -<p>一旦你决定了想做什么任务,找一个具体的页面、示例代码等等就开动吧,尽管去做!</p> +<p>一旦你找到了一个想要改善的页面,或者想要修改的示例代码等等任何你想改进的内容,那就不要犹豫,尽管去做!</p> -<p>别担心做得是否完美,其他的 MDN 贡献者会来帮助修复那些错漏。如果你想尝试一下在 MDN 上编辑内容的感觉,或想在“真的做”一些事情之前实验一下,你可以在<a href="/en-US/docs/Sandbox">沙盒</a>页面上练练手。如果你有疑问,请到<a href="/zh-CN/docs/MDN/Community">交流社区</a>页面获取邮件列表和在线聊天频道,在那里你可以找到答案。</p> +<h3 id="step_4_ask_for_help">第四步:寻求帮助</h3> -<p>完成任务之后,若恰巧时间空闲,你可以选择另一个项任务,或者看看下面<a href="#其它你可以在MDN上做的事情">其它你可以在 MDN 上做的事情</a>。</p> - -<h2 id="可选的任务类型">可选的任务类型</h2> - -<p>基于你的技能和兴趣,你有很多方法可以帮助到 MDN。尽管一些任务可能是艰巨的,但同时我们也有很多相对简单的任务。很多只需要五分钟(或更少!)。通过做任务和阅读它的简短描述,你会发现每一种类型的任务通常都是需要近似的时间的。</p> - -<h3 id="选项_1:我喜欢文字">选项 1:我喜欢文字</h3> - -<p>你可以帮我们审核或编辑现有的文档,并对它们应用正确的标签。</p> - -<ul> - <li><a href="/zh-CN/docs/MDN/Contribute/Howto/Set_the_summary_for_a_page">设置一个页面的摘要</a>(5 - 15 分钟)</li> - <li><a href="/zh-CN/docs/MDN/Contribute/Howto/Do_an_editorial_review">编辑评论</a>(5 - 30 分钟)</li> - <li><a href="/zh-CN/docs/MDN/User_guide/Writing#Editing_an_existing_page">使用新的信息更新现有的文章</a>(5 分钟 - 1 小时)</li> - <li><a href="/zh-CN/docs/MDN/Contribute/Howto/Write_a_new_entry_in_the_Glossary">在术语表里新增一个条目</a>(15 分钟 - 1 小时)</li> - <li><a href="/zh-CN/docs/MDN/User_guide/Writing#Adding_a_new_page">为新的技术或 API 写一篇文章</a>(30 分钟 - 2 小时)</li> - <li><a href="/zh-CN/docs/MDN/Contribute/Howto/Write_an_article_to_help_learn_about_the_Web">写一篇文章,帮助人们了解 Web</a>(1 - 3 小时)</li> -</ul> - -<div class="note"> -<p><strong>注意:</strong>在你审查已有的文章或者编写新的文章之前,最好先看一下我们的<a href="/zh-CN/docs/Project:MDN/Style_guide">风格指南</a>,这有助于保证大家写出的文章的风格是一致的。</p> -</div> - -<h3 id="选项_2:我喜欢代码">选项 2:我喜欢代码</h3> - -<p>我们需要更多的代码示例!你也可以帮助构建我们的网站平台 —— <a href="https://developer.mozilla.org/zh-CN/docs/MDN/Kuma">Kuma</a>!</p> +<p>当你感到无从下手的时候,可以试着去寻求他人的帮助。下面列出了几种供你选择的方法。</p> <ul> - <li><a href="/zh-CN/docs/MDN/Contribute/Howto/Convert_code_samples_to_be_live">将示例代码转换为“实时的”</a>(30 分钟)</li> - <li><a href="https://kuma.readthedocs.io/en/latest/installation.html">建立一个 Kuma 的编程环境</a>(1 小时)</li> - <li><a href="https://github.com/mozilla/kuma#readme">发送你的代码补丁到 Kuma 的代码库</a>(1 小时)</li> - <li><a href="https://wiki.mozilla.org/Webdev/GetInvolved/developer.mozilla.org">提交新的 Demo</a>(1 小时)</li> + <li>如果你想和我们通过在线交流的方式,讨论一些关于 MDN 网站的问题, 你可以加入<a href="https://chat.mozilla.org/#/room/#mdn:mozilla.org">我们的聊天室</a>。多说一句,它使用 <a href="https://wiki.mozilla.org/Matrix">Matrix</a> 这个很酷的协议。</li> + <li>你也可以向<a href="mailto:mdn-admins@mozilla.org">mdn-admins@mozilla.org</a>发邮件来和我们交流。</li> + <li>如果你在学习 Web 的过程中遇到一些难以解决的代码问题, 你可以在这个<a href="https://discourse.mozilla.org/c/mdn/learn/250">活跃中的论坛</a>提出你的问题。</li> </ul> -<h3 id="选项_3:我喜欢文字和代码">选项 3:我喜欢文字和代码</h3> - -<p>我们有需要的技术和语言技能的任务,像写新文章,审查技术的准确性,或改编文档等。</p> - -<ul> - <li><a href="/zh-CN/docs/MDN/Contribute/Howto/Tag_JavaScript_pages">给 JavaScript 页面添加标签</a> (5 分钟)</li> - <li><a href="/zh-CN/docs/MDN/Promote">在你自己的网站上推广 MDN</a>(5 分钟)</li> - <li><a href="/zh-CN/docs/MDN/Contribute/Howto/Do_a_technical_review">技术评论</a>(30 分钟)</li> - <li><a href="/zh-CN/docs/MDN/Contribute/Contribute_to_docs_that_are_currently_needed">写一篇关于你感兴趣的话题的文章</a>(1 小时及以上)</li> - <li><a href="/zh-CN/docs/MDN/Contribute/Howto/学习_交互_在线_起步_开始">创建互动练习以帮助人们了解 Web</a>(1 小时及以上)</li> - <li>从<a href="http://www.joshmatthews.net/bugsahoy/?mdn=1"> Bug Ahoy 的 MDN 目录</a>中<a href="/en-US/docs/MDN/Contribute/Howto/Resolve_a_mentored_developer_doc_request">修复一个文档 bug</a> (1 小时及以上)</li> -</ul> +<p>不用担心做得不够完美,其他参与其中的贡献者们将会找出那些你没注意到的错误。</p> -<h3 id="选项_4:我想翻译_MDN">选项 4:我想翻译 MDN</h3> - -<p>所有的本地化与翻译工作是由我们优秀的MDN社区志愿者做的。</p> - -<ul> - <li><a href="/zh-CN/docs/MDN/Contribute/Localize/Translating_pages">翻译页面</a>(2小时)(<a href="/zh-CN/docs/MDN/Doc_status/l10nPriority">查看优先级</a>)</li> - <li>连接其它在<a href="/zh-CN/docs/MDN/Contribute/Localize/Localization_projects">本地化项目</a>里列出的本地化人员名单(30分钟)</li> -</ul> +<h2 id="useful_complete_beginners_guides">新人推荐</h2> -<h3 id="选项_5_我发现了一些错误的信息,但我不知道该怎样修复它">选项 5: 我发现了一些错误的信息,但我不知道该怎样修复它</h3> - -<p>你可以在 <a href="https://bugzilla.mozilla.org/enter_bug.cgi?product=Mozilla%20Developer%20Network">Bugzilla 上提交 </a><a href="https://bugzilla.mozilla.org/enter_bug.cgi?product=Mozilla%20Developer%20Network">bug</a>。(5分钟)</p> - -<table class="standard-table"> - <tbody> - <tr> - <td><strong>Bugzilla</strong>字段</td> - <td>内容</td> - </tr> - <tr> - <td>产品</td> - <td><a href="https://bugzilla.mozilla.org/enter_bug.cgi?product=Developer+Documentation">开发者文档 </a></td> - </tr> - <tr> - <td>组件</td> - <td>选择一个适合其主题的范围。当你不确定或者没有找到合适的主题时,可以选择“General”</td> - </tr> - <tr> - <td>URL</td> - <td>你发现问题的页面</td> - </tr> - <tr> - <td>描述</td> - <td>请尽你所能的去描述这个问题,并且谈谈在何处能找到正确的解决方案。这一内容既可以是其他人(交谈中涉及到的),也可以是网页链接</td> - </tr> - </tbody> -</table> - -<h2 id="其它可以在_MDN_上做的事情">其它可以在 MDN 上做的事情</h2> +<p>我们希望在你参与到项目之前,有一定的准备知识。如果你对下面列出的名词还不是很熟悉,后面附了一些链接,可以帮助你提高工作效率:</p> <ul> - <li><a href="/zh-CN/docs/Project:en/Project:Community">加入 MDN 社区</a>。</li> - <li><a href="/zh-CN/profile">填写你的个人资料</a>以便其他人能更了解你。</li> - <li>了解更多关于如何<a href="/zh-CN/docs/MDN/Contribute">贡献 MDN</a>。</li> - <li><a href="/zh-CN/docs/MDN/Getting_started/Using_MDN_in_education">使用 MDN 进行学习</a></li> + <li><strong>Web 技术</strong>:如果你刚刚开始了解 HTML、CSS、JavaScript 等相关知识,你可以试着完成我们的 <a href="/zh-CN/docs/Learn">Web 开发教程</a>。</li> + <li><strong>开源</strong>:如果你之前从未参与过开源项目,可以读一读<a href="/zh-CN/docs/MDN/Contribute/Open_source_etiquette">开源项目的基本礼节</a>。</li> + <li><strong>Git 和 GitHub</strong>:如果你对这些工具不是很熟悉,MDN 上这篇<a href="/zh-CN/docs/MDN/Contribute/GitHub_beginners">GitHub 新手入门</a>可以帮到你。</li> + <li><strong>MDN 的仓库结构</strong>:如果你不清楚你编辑的内容会提交到哪个仓库,你可以了解一下<a href="/en-US/docs/MDN/Contribute/Where_is_everything">我们的仓库是如何分类的</a>。</li> </ul> |