開始入門 MDN
這是一個開放的開發者和作家社區,不分品牌、瀏覽器、平台,為更好的 Web 構建提供更多資源。每個人都能做出貢獻,而每個貢獻者的付出都讓我們變得更為壯大。要想持續推動 Web 創新、成就更為偉大的事物?就讓我們和你一起,從這裡開始。
MDN 上的每一個部分(網站本身的程式、文件、程式範例、效果展示等等)都是由一群開發者及文案編輯組成的社群完成。術業有專攻,你也一定有些妙招可以分享,請加入我們!
MDN 三步驟快速上手
MDN 是一個 wiki,每個人都可以添加、編撰內容。你不必得是個了解許多技術的程式設計師才能加入,畢竟總有各種事情需要完成,從簡單如校對與糾正拼寫,到複雜如撰寫 API 文件都有。這個導向將引導你開始和幫助你找到可以幫助提升 MDN 内容的方法。
加入貢獻非常容易,且即使你不慎犯了錯誤,也很容易修正。就算你不知道文件該怎麼編排,或者不太了解語法,也不用煩惱:我們有一群人就是專門努力巡視四周、盡力確保 MDN 上的內容優質依舊;有人會盡力編輯你的貢獻確保文件格式正確。放膽分享你的所學吧,並相信整個社群能幫你做得更好。
步驟 1:建立 MDN 帳號
步驟 2:找件事來完成
現在你已經登入完畢,請閱讀下面列表中不同工作的描述,找出最吸引你的一個。你可以任選一個喜歡的工作作為第一步。
步驟 3:動手
一旦決定了想做什麼事,就找個特定的頁面、程式碼範例之類的,然後開工吧!
別擔心你無法做到完美,會有 MDN 成員來幫忙修復問題與錯誤。有任何疑問,都歡迎到社群網頁上查詢郵件群組、聊天頻道等資訊,協助你找尋答案。
备注: 如果你想要在編輯 MDN 之前做些實際的試驗,那麽我們有提供一個沙盒(Sandbox)給你體驗。請將你的試驗限制在這個頁面。請不要為了看看會發生什麽而在内容頁做不必要的變動,這會弄得一團糟讓其他人搞不清楚,更糟糕的是,會讓一些衹是想學點或看點什麽的讀者混亂。
完成這項工作以後,歡迎再挑另一件事情做,或者看看其他可以在 MDN 上做的事。
各種工作內容
貢獻 MDN 的方法很多,要選哪種就端看你的技能和興趣來決定。儘管有些工作可能很難,但我們也真的有好多比較單純的事情可以做。很多工作大概只需要花你五分鐘時間(甚至不到!)。在每項工作的簡短說明後方,你可以看到各類型工作所需的推估時間。
選項 1: 給熱愛文字的人
你可以幫我們審查或編輯現有的文件,並為其加上正確的標籤。
- 撰寫文件摘要 (5-15 分鐘)
- 編輯審查(5–30 分鐘)
- 在詞彙表中加上新的詞彙(15 分鐘-1 小時)
- 撰寫幫助大眾了解 Web 的文章(1 小時-3 小時)
备注: 如果你要審查或撰寫新文章,建議先看一下文件體例。這樣能確保文章的一貫性。
選項 2: 給熱愛程式碼的人
我們需要更多的代碼示例!你也可以幫助建立我們的網站平臺,Kuma!
- 轉換示例代碼是「可用的」(30 分鐘)
- 閱讀參與的指引(30 分鐘)
- 設定 Kuma 的組建環境(1 小時)
- 把你的程式更新到 Kuma 程式庫 (1 小時)
選項 3: 我喜歡文字和代碼
我們有需要的技術和語言技能的任務,像寫新文章,審查技術的準確性,或調整文檔。
- 在你的網站推廣 MDN(5 分鐘)
- 技術評論(30 分鐘)
- 撰寫當前主題所需要的文章(1 小時以上)
- 撰寫能幫人理解 web 的互動示範(1 小時以上)
- 從MDN category in Bugs Ahoy修復文件錯誤(1 小時以上)
選項 4: 我希望 MDN 有我的語言
所有的本地化和翻譯的工作,都是由我們的驚豔地 MDN 社區志願者所完成。
- 翻譯頁面(2 小時)(參見 top priorities)
- 與其他列在本地化專案裡面的朋友聯繫(30 分鐘)
選項 5: 我發現了一些錯誤的資訊,但我不知道該怎樣修復它
你可以在 Bugzilla 上提交 bug。(5 分鐘)