aboutsummaryrefslogtreecommitdiff
path: root/files/zh-tw/mdn/contribute/getting_started/index.html
blob: 36b6a40f036a033baaa7bc2a9d2f54154ec80f52 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
---
title: 開始入門 MDN
slug: MDN/Contribute/Getting_started
tags:
  - Beginner
  - Getting Started
  - Guide
  - MDN Meta
  - 入門
translation_of: MDN/Contribute/Getting_started
---
<div>{{MDNSidebar}}{{IncludeSubnav("/zh-TW/docs/MDN")}}</div>

<p>這是一個開放的開發者和作家社區,不分品牌、瀏覽器、平台,為更好的 Web 構建提供更多資源。每個人都能做出貢獻,而每個貢獻者的付出都讓我們變得更為壯大。<span class="ordinary-span-edit">要想持續推動 Web 創新、成就更為偉大的事物?就讓我們和您一起,從這裡開始。</span></p>

<p>MDN 上的每一個部分(網站本身的程式、文件、程式範例、效果展示等等)都是由一群開發者及文案編輯組成的社群完成。術業有專攻,您也一定有些妙招可以分享,請加入我們!</p>

<h2 id="MDN_三步驟快速上手"><span>MDN 三步驟快速上手</span></h2>

<p><span class="seoSummary">MDN 是一個 wiki,<strong>每個人</strong>都可以添加、編撰內容。您不必得是個了解許多技術的程式設計師才能加入,畢竟總有各種事情需要完成,從簡單如校對與糾正拼寫,到複雜如撰寫 API 文件都有。這個導向將引導您開始和幫助您找到可以幫助提升 MDN 内容的方法。</span></p>

<p>加入貢獻非常容易,且即使您不慎犯了錯誤,也很容易修正。就算您不知道文件該怎麼編排,或者不太了解語法,也不用煩惱:我們有一群人就是專門努力巡視四周、盡力確保 MDN 上的內容優質依舊;有人會盡力編輯您的貢獻確保文件格式正確。放膽分享您的所學吧,並相信整個社群能幫您做得更好。</p>

<h3 id="步驟_1:建立_MDN_帳號">步驟 1:建立 MDN 帳號</h3>

<p>加入貢獻的第一步是要有 MDN 帳號,請參考<a href="/docs/MDN/Contribute/Howto/Create_an_MDN_account">建立帳號說明</a>。注意,在建立 MDN 帳號之前,您需要有一個 <a href="https://github.com/join">GitHub帳號</a>,因為我們已經使用 GitHub 作為登入驗證。</p>

<p>如果你想創建一個新的頁面,請參考{{SectionOnPage("/zh-TW/docs/MDN/Contribute/Howto/Create_and_edit_pages", "新增一個新頁面")}},這裏有關於如何獲得創建新頁面許可的重要信息;出於安全考慮,新賬戶默認沒有此功能。</p>

<h3 id="步驟_2:找件事來完成">步驟 2:找件事來完成</h3>

<p>現在您已經登入完畢,請閱讀<a href="#各種工作內容">下面列表</a>中不同工作的描述,找出最吸引您的一個。您可以任選一個喜歡的工作作為第一步。</p>

<h3 id="步驟_3:動手">步驟 3:動手</h3>

<p>一旦決定了想做什麼事,就找個特定的頁面、程式碼範例之類的,然後開工吧!</p>

<p>別擔心您無法做到完美,會有 MDN 成員來幫忙修復問題與錯誤。有任何疑問,都歡迎到<a href="/docs/MDN/Community">社群網頁</a>上查詢郵件群組、聊天頻道等資訊,協助您找尋答案。</p>

<div class="note">
<p>如果您想要在編輯 MDN 之前做些實際的試驗,那麽我們有提供一個沙盒(<strong><a href="/zh-TW/docs/Sandbox">Sandbox</a>)</strong>給您體驗。請將您的試驗限制在這個頁面。請不要為了看看會發生什麽而在内容頁做不必要的變動,這會弄得一團糟讓其他人搞不清楚,更糟糕的是,會讓一些衹是想學點或看點什麽的讀者混亂。</p>
</div>

<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-TW/docs/MDN/Contribute/Howto/Set_the_summary_for_a_page">撰寫文件摘要</a> (5-15 分鐘)</li>
 <li><a href="/zh-TW/docs/MDN/Contribute/Howto/Do_an_editorial_review">編輯審查</a>(5–30 分鐘)</li>
 <li><a href="/zh-TW/docs/MDN/Contribute/Howto/Write_a_new_entry_in_the_Glossary">在詞彙表中加上新的詞彙</a>(15 分鐘-1 小時)</li>
 <li><a href="/zh-TW/docs/MDN/Contribute/Howto/Write_an_article_to_help_learn_about_the_Web">撰寫幫助大眾了解 Web 的文章</a>(1 小時-3 小時)</li>
</ul>

<div class="note">如果您要審查或撰寫新文章,建議先看一下<a href="/zh-TW/docs/MDN/Contribute/Guidelines/Style_guide">文件體例</a>。這樣能確保文章的一貫性。</div>

<h3 id="選項_2_給熱愛程式碼的人">選項 2: 給熱愛程式碼的人</h3>

<p>我們需要更多的代碼示例!你也可以幫助建立我們的網站平臺,<a href="https://developer.mozilla.org/zh-TW/docs/MDN/Kuma">Kuma</a></p>

<ul>
 <li><a href="/zh-TW/docs/MDN/Contribute/Howto/Convert_code_samples_to_be_live">轉換示例代碼是「可用的」</a>(30分鐘)</li>
 <li><a href="https://wiki.mozilla.org/Webdev/GetInvolved/developer.mozilla.org">閱讀參與的指引</a>(30分鐘)</li>
 <li><a href="http://kuma.readthedocs.org/en/latest/installation.html">設定 Kuma 的組建環境</a>(1 小時)</li>
 <li><a href="https://github.com/mozilla/kuma#readme">把你的程式更新到 Kuma 程式庫</a> (1 小時)</li>
</ul>

<h3 id="選項_3_我喜歡文字和代碼">選項 3: 我喜歡文字和代碼</h3>

<p>我們有需要的技術和語言技能的任務,像寫新文章,審查技術的準確性,或調整文檔。</p>

<ul>
 <li><a href="/zh-TW/docs/MDN/About/Promote">在你的網站推廣 MDN</a>(5 分鐘)</li>
 <li><a href="/zh-TW/docs/MDN/Contribute/Howto/Do_a_technical_review">技術評論</a>(30 分鐘)</li>
 <li><a href="/zh-TW/docs/Contribute_to_docs_that_are_currently_needed">撰寫當前主題所需要的文章</a>(1 小時以上)</li>
 <li><a href="/zh-TW/docs/MDN/Contribute/Howto/Create_an_interactive_exercise_to_help_learning_the_web">撰寫能幫人理解 web 的互動示範</a>(1 小時以上)</li>
 <li><a href="http://www.joshmatthews.net/bugsahoy/?mdn=1">MDN category in Bugs Ahoy</a>修復<a href="/zh-TW/docs/MDN/Contribute/Howto/Resolve_a_mentored_developer_doc_request">文件錯誤</a>(1 小時以上)</li>
</ul>

<h3 id="選項_4_我希望MDN有我的語言">選項 4: 我希望MDN有我的語言</h3>

<p>所有的本地化和翻譯的工作,都是由我們的驚豔地 MDN 社區志願者所完成。</p>

<ul>
 <li><a href="/zh-TW/docs/MDN/Contribute/Localize/Translating_pages">翻譯頁面</a>(2 小時)(參見 <a href="/zh-TW/docs/MDN/Doc_status/l10nPriority">top priorities</a></li>
 <li>與其他列在<a href="/zh-TW/docs/MDN/Contribute/Localize/Localization_projects">本地化專案</a>裡面的朋友聯繫(30 分鐘)</li>
</ul>

<h3 id="選項_5_我發現了一些錯誤的資訊,但我不知道該怎樣修復它">選項 5: 我發現了一些錯誤的資訊,但我不知道該怎樣修復它</h3>

<p>你可以在 <a href="https://bugzilla.mozilla.org/enter_bug.cgi?product=Mozilla%20Developer%20Network">Bugzilla 上提交 bug</a>。(5分鐘)</p>

<h2 id="其他可以在_MDN_上做的事">其他可以在 MDN 上做的事</h2>

<ul>
 <li><a href="/zh-TW/docs/MDN/Community">加入 MDN 社群</a></li>
 <li><a href="/zh-TW/profile">填寫你的個人資料</a>以便其他人能更瞭解你</li>
 <li>多理解如何<a href="/zh-TW/docs/MDN/Contribute">貢獻 MDN</a></li>
</ul>