如何建設 MDN 學習專區

翻譯不完整。請協助 翻譯此英文文件

無論你是初來乍到、抑或尋至深處無怨尤、都應該是對貢獻 MDN 學習專區起了興趣吧。那很棒!

在這裡,你會看到該如何改進 MDN 學習專區的內容。視你的時間多寡、以及你是初學者網路開發者教師而定,有一些你可以完成的事情。

注意:你可以在如何撰寫幫助別人理解 Web 的文章裡面找到指引如何撰寫學習專區的新文章。

找到特定的任務

貢獻者們使用 Trello board 來組織工作事務。你可以透過這個方法,找出某個專案的工作。要加入的話,只要 建立一個 Trello 的帳號、然後去 ping Chris Mills 叫他給你撰寫 board 的權限。

Contributing is a great way to have some fun while learning new stuff. If you ever feel lost or have questions, don't hesitate to reach us on our mailing list or IRC channel (see at the bottom of this page for details). Chris Mills is the topic driver for the Learning Area — you could also try pinging him directly.

接下來的章節,會提供一些在你所能下的常見點子。

我是初學者

真棒!初學者在學習專區的創建與給予回饋,不但重要還很寶貴。You have a unique perspective on these articles as a member of their target audience, which can make you an invaluable member of our team. Indeed, if you're using one of our articles to learn something and you get stuck, or find the article confusing in some way, you can either fix it or let us know about the problem so we can be sure it gets fixed.

我們建議你可以透過以下方法貢獻:

給我們的文章添加標籤(約五分鐘)
給 MDN 的文章添加標籤,是向 MDN 貢獻的最簡單方法。我們有很多功能會透過標籤助以呈現內文資訊,所以幫忙標籤的建設相當寶貴。從沒有任何標籤的術語表以及學習專區開始吧。
閱讀並評價術語表(約五分鐘)
我們需要身為初學者的眼光,來檢視我們的內容。如果你發現某個術語難以理解,就表示該術語需要改進。你可以作任何認為有需要的更動。如果你不認為自己有修改該術語的技能,至少請透過我們的郵件清單告訴我們。
撰寫新的術語(約二十分鐘)
這是最有效的新技能學習法。選一個你想理解的概念去研究。接著,撰寫這個術語。和別人解釋,是「固著」你腦內知識的好方法。既幫自己理解所知、也幫了其他人。利人利己,大家都贏!
閱讀並評價術語表學習專區的文章(約兩小時)
和閱讀術語表差不多,但因為文章會更長了些,所以要花更多時間。

我是網路開發者

好極了!我們需要你的技能,來確保我們教給初學者的內容正確無誤。因為這裡的宗旨是理解網路,請確保解釋儘可能簡單,但不致毫無用處。比起過度精確,可以理解才是最重要的。

閱讀並評價術語表(約五分鐘)
As a web developer, we need you to make sure our content is technically accurate without being too pedantic. Feel free to make any change you think is necessary. If you want to discuss the content before editing, ping us on our mailing list or IRC channel.
撰寫新的術語(約二十分鐘)
Clarifying technical jargon is a very good way to learn and be both technically accurate and simple. Beginners will thank you for that. We have many undefined terms which need your attention. Pick one and you're good to go.
閱讀並評價術語表學習專區的文章(約兩小時)
This is the same thing as reviewing a glossary entry (see above); it just takes a bit more time as those articles are quite a bit longer.
撰寫新的學習專區文章 (4 hours or more)
MDN is lacking simple straightforward articles about using web technologies (HTML, CSS, JavaScript, etc). We also have old content on MDN that deserves to be reviewed and reshaped. Push your skills to the limit to make web technologies usable even by beginners.
Create exercises, code samples or interactive learning tools (? hours)
All our learning articles require what we call "active learning" materials, because people learn best by doing something themselves. Such materials are exercises or interactive content that help a user to apply and manipulate the concepts detailed in an article. There are many possible ways to make active learning content, from creating code samples with JSFiddle or similar, to building fully hackable interactive content with Thimble. Unleash your creativity!

我是教師

MDN 有著精良的技術史,但我們對教導新人觀念的最佳方法,缺乏深入了解。針對這方面,我們需要借重做為教師或導師身份的你。你能幫我們確保給讀者們的內容,有著良好而實用的教育路徑(educational track)。

閱讀並評價術語表(約十五分鐘)
Check out a glossary entry and feel free to make any changes you think are necessary. If you want to discuss the content before editing, ping us on our mailing list or IRC channel.
撰寫新的術語(約一小時)
Clear, simple definitions of terms and basic overviews of concepts in the glossary are critical in meeting beginners' needs. Your experience as an educator can help create excellent glossary entries; we have many undefined terms which need your attention. Pick one and go for it.
Add illustrations and/or schematics to articles (1 hour)
As you might know, illustrations are an invaluable part of any learning content. This is something we often lack on MDN and your skills can make a difference in that area. Check out the articles that lack illustrative content and pick one you'd like to create graphics for.
Read and review a learning article (2 hours)
This is similar to reviewing glossary entries (see above), but it requires more time since the articles are typically quite a bit longer.
Write a new learning article (4 hours)
We need simple, straightforward articles about the Web ecosystem and other functional topics around it. Since these learning articles need to be educational rather than trying to literally cover everything there is to know, your experience in knowing what to cover and how will be a great asset.
Create exercises, quizzes or interactive learning tools (? hours)
All our learning articles require "active learning" materials. Such materials are exercises or interactive content which help a user learn to use and expand upon the concepts detailed in an article.  There are lots of things you can do here, from creating quizzes to building fully hackable interactive content with Thimble. Unleash your creativity!
Create learning pathways (? hours)
In order to provide progressive and comprehensible tutorials, we need to shape our content into pathways. It's a way to gather existing content and figure out what is missing to create a learning article to write.

Join the Learn community

Choose your preferred method for joining the discussion:

文件標籤與貢獻者

 此頁面的貢獻者: iigmir
 最近更新: iigmir,