This set of slides accompanies the MDN workshop held at BrazilJS 2014. It features a guide to getting started with contributing to the Mozilla Developer Network documentation resource, and links to JavaScript and API work to get started on.
6. You just have to log in...
• This is mainly just to cut down on some spam
• And to share recognition, and blame!
• You can log in with Persona
7. Once logged in
• You can edit pages
• Translate pages
• Create new pages
8. You should also
• Report bugs at bugzilla.mozilla.org (project: Mozilla
Developer Network :: General)
• Get help on lists.mozilla.org/listinfo/dev-mdc
• Get help on IRC (wiki.mozilla.org/IRC, room #mdn)
• Ask us questions!
10. Don’t be afraid
• Hit that edit button
• And kick some ass
• At the very worst, we can revert changes
• But we’d rather you edit stuff than send us bugs!
• We don’t expect perfect language and styling
14. Code samples
• The best way to provide code samples is to use your
favourite mechanism
• We’d recommend Github…
• …but you could use JSBin, or JSFiddle, or … ;-)
15. Macros
• Written in KumaScript, which is pretty much just JS
• https://developer.mozilla.org/en-US/docs/
Project:MDN/Contributing/Custom_macros
• For example, {{HTMLElement("div")}} is found at
developer.mozilla.org/en-US/docs/
Template:HTMLElement
16. Translations
• Don’t just start translating the English page!
• Use the translation menu up the top of the article
• Select Add a translation
• Select language
• Then use the provided interface
19. Translation updates
• Keeping translations updated can be a pain…
• …when the original changes
• Use the “subscribe” feature to
watch pages you’ve translated
20. Kuma development
• If you are a ninja (or at least a samurai, or pirate)
• You could help develop the system
• It’s on Github
• github.com/mozilla/kuma
• developer.mozilla.org/en-US/docs/Project:MDN/
Kuma/Contributing
22. In this session
• We wanted to focus on JavaScript, Glossary & APIs
• See https://etherpad.mozilla.org/braziljs-workshop-
mdn
• Also see https://developer.mozilla.org/en-US/docs/
MDN/Doc_status
• Want to work on something? put your name on it
• If you want to work on something else, talk to us!
24. Didn’t we do well!
• Let’s look at what we did during the workshop
• Ask questions
• Get t-shirts
• Go have fun
• Come visit our booth at BrazilJS!
