這裡不分品牌、瀏覽器、平台,我們都是希望能為美好的 Web 未來提供更多資源。大家都能貢獻,而每個貢獻者都讓我們更為壯大。要想持續推動 Web 創新、成就更為偉大的事物?就讓我們和您一起,從這裡開始。
MDN 上的每一個部分(網站本身的程式、文件、程式範例、效果展示等等)都是由一群開發者及文案編輯組成的社群完成。術業有專攻,您也一定有些妙招可以分享,請加入我們!
MDN 三步驟快速上手
MDN 是一個 wiki,每個人都可以添加、編撰內容。您不必得是個了解許多技術的程式設計師才能加入,畢竟總有各種事情需要完成,從簡單(校對、糾正拼寫)到複雜(寫作API文檔)都有。
加入貢獻非常容易,且即使您不慎犯了個錯誤,也很容易修正。就算您不知道文件該怎麼編排,或者不太了解語法,也不用煩惱:我們有一群人就是專門努力巡視四周、盡力確保 MDN 上的內容優質依舊;有人會盡力編輯您的貢獻確保文件格式正確,所以就放膽分享您的所學吧!
步驟 1:建立 MDN 帳號
加入貢獻的第一步是要有 MDN 帳號,請參考建立帳號說明。
步驟 2:找件事來完成
現在您已經登入完畢,請閱讀下面列表中不同工作的描述,找出最吸引您的一個。您可以任選一個喜歡的工作作為第一步。
步驟 3:動手
一旦決定了想做什麼事,就找個特定的頁面、程式碼範例之類的,然後開工吧!
別擔心您無法做到完美,會有 MDN 成員來幫忙修復問題與錯誤。有任何疑問,都歡迎到社群網頁上查詢郵件群組、聊天頻道等資訊,協助您找尋答案。
注意:如果您想在實際動手前先「測試」一下,可以先到 Sandbox 頁面隨意玩玩。如果要測試什麼東西,請都在那一頁做就好,避免只是為了「看看效果如何」就動手改任何內容頁面,不然負責清理的志工就又有得忙啦 :P
完成這項工作以後,歡迎再挑另一件事情做,或者看看其他可以在 MDN 上做的事。
各種工作內容
貢獻 MDN 的方法很多,要選哪種就端看您的技能和興趣來決定。儘管有些工作可能很難,但我們也真的有好多比較單純的事情可以做。很多工作大概只需要花您五分鐘時間(甚至不到!)。在每項工作的簡短說明後方,您可以看到各類型工作所需的推估時間。
選項 1: 給熱愛文字的人
您可以幫我們審查或編輯現有的文件,並為其加上正確的標籤。
- 撰寫文件摘要(5-15 分鐘)
- 編輯審查(5–30 分鐘)
- 以新資訊更新現有的文章(5 分鐘-1 小時)
- 在詞彙表中加上新的詞彙(15 分鐘-1 小時)
- 撰寫新的技術或API的文章(30 分鐘-2 小時)
- 撰寫幫助大眾了解 Web 的文章(1 小時-3 小時)
注意:如果您要審查或撰寫新文章,請記得先看一下文件體例,這樣才能幫助大家寫出風格相近的文件。
選項 2: 給熱愛看 Code 的人
我們需要更多的代碼示例!你也可以幫助建立我們的網站平臺,Kuma!
- 轉換示例代碼是“可用的”(30分鐘)
- 建立一個Kuma的程式設計環境(1小時)
- 發送你的代碼補丁到Kuma的代碼庫(1小時)
- 提交一個新的演示(1小時)
選項 3: 我喜歡文字和代碼
我們有需要的技術和語言技能的任務,像寫新文章,審查技術的準確性,或調整文檔。
- 標記JavaScript網頁(5分鐘)
- 推進MDN在你自己的網站(5分鐘)
- 技術評論(30分鐘)
- 更新API頁面配置(30分鐘)
- 寫一個你熟悉內容的新文章(1小時以上)
選項 4: 我希望MDN有我的語言
所有的當地語系化和翻譯工作是由我們的令人驚訝的MDN社區志願者做的。
選項 5: 我發現了一些錯誤的資訊,但我不知道該怎樣修復它
你可以在 Bugzilla 上提交 bug。(5分鐘)
注意在新建 bug 時要按照下面說的規則填寫:
Bugzilla 頁面中的欄位名 | 應該選擇或填寫的內容 |
product |
Developer Documentation |
component |
[經可能選擇正確的 component,如果實在不知道選哪個,就選 "General" 好了] |
URL |
你發現問題的頁面位址 |
Description |
盡可能把錯誤的資訊描述清楚,還可以附上一些連結來證實自己的說法。 |