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.

1. MDN Workshop
BrazilJS 2014

2. Hello!
1. Let’s say hi…
2. …learn what to do…
3.…and write some awesome docs and demos!
!
Slides at slideshare.net/chrisdavidmills/braziljs-mdn

3. Hello!

4. Today’s personnel
• Florian Scholz: JavaScript ref docs
• Chris Mills: API docs
• Ricardo Brandão: Translations and local support

5. How to contribute

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!

9. Editing

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

11. Edit toolbar
!
!
!
developer.mozilla.org/en-US/docs/Project:MDN/
Contributing/Editor_guide

12. Footer controls

13. Create a new article

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

17. Translations

18. Translations

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

21. What to work on

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!

23. The aftermath

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!

25. Thanks!
cmills@mozilla.com || @chrisdavidmills
fscholz@mozilla.com || @floscholz