我們正在開發建設資源,更好的網路開放的社區,無論是品牌、瀏覽器或是平臺。每個人都可以參與,每個人都會讓我們更強大。我們可以一起繼續推動Web創新服務於更廣泛的利益。我們和你一起在這裡開始。
每一部分的MDN(文檔,演示,和網站本身)是由開發商開放的社區創建。請加入我們!
3個簡單的 MDN 步驟
MDN 是一個 wiki,讓大家都可以添加和編輯內容。你不必是一個程式師或瞭解許多技術。有一個需要完成的任務是從簡單的(校對和糾正拼寫)到複雜的(寫作API文檔)。
貢獻是既容易又安全。即使你犯了一個錯誤,也很容易修補。即使你不知道怎樣看一種東西,或者你的語法不是很好,別擔心!我們有一個團隊,這是確保MDN的內容盡可能好的工作。有人會確保你的成果既整潔又寫得不錯的。
步驟 1: 創建一個MDN帳號
在開始你的貢獻到MDN前,你需要有一個MDN帳號。有關詳細資訊,請參閱如何創建一個帳戶。
步驟 2: 選擇一個任務並完成
現在你已經登錄,在下面的列表裡閱讀不同任務的描述,並決定哪一個最吸引你。你可以選擇任何你喜歡的任務來邁出你的第一步。
步驟 3: 做任務
一旦你決定了想做什麼樣的任務,就去找一個特定的頁面、程式碼範例之類的。然後開工吧!
別擔心做得是否完美;其他MDN貢獻者會來幫忙修復錯誤和疏忽。如果你想在做“真正”的東西之前先實驗下,您可以編輯沙箱網頁。 如果你有問題,你可以參看在郵寄清單中的資訊社區網頁和聊天頻道,你可以找到答案。
當你完成的時候,覺得空閒可以選擇另一個項目,或者看下面的MDN可以做的其他事情。
可能的任務類型
基於你的技能和興趣,有很多方法可以幫助MDN。儘管一些任務可能是艱巨的,我們有很多簡單的活動可進行。很多人只需要五分鐘(或更少!)。隨著任務和它的簡短描述,你會發現每一種類型的任務通常需要近似的時間。
選項 1: 我喜歡文字
你可以幫我們審查或編輯現有的文檔,並對它們應用正確的標籤。
- 設置一個頁面的摘要(5-15分鐘)
- 編輯評論(5–30分鐘)
- 隨著新的資訊更新現有的文章(5 分鐘-1小時)
- 寫關於新的技術或API的一篇文章(30 分鐘-2小時)
注意:在你審查已有的文章或者編寫新的文章之前,最好先看一下我們的風格指南,這樣有助於確保大家寫出的文章的風格是一致的。
選項 2: 我喜歡代碼
我們需要更多的代碼示例!你也可以幫助建立我們的網站平臺,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 |
盡可能把錯誤的資訊描述清楚,還可以附上一些連結來證實自己的說法。 |