BrazilJS MDN

489 views
394 views

Published on

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.

Published in: Technology
0 Comments
0 Likes
Statistics
Notes
  • Be the first to comment

  • Be the first to like this

No Downloads
Views
Total views
489
On SlideShare
0
From Embeds
0
Number of Embeds
3
Actions
Shares
0
Downloads
1
Comments
0
Likes
0
Embeds 0
No embeds

No notes for slide

BrazilJS MDN

  1. 1. MDN Workshop BrazilJS 2014
  2. 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. 3. Hello!
  4. 4. Today’s personnel • Florian Scholz: JavaScript ref docs • Chris Mills: API docs • Ricardo Brandão: Translations and local support
  5. 5. How to contribute
  6. 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. 7. Once logged in • You can edit pages • Translate pages • Create new pages
  8. 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. 9. Editing
  10. 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. 11. Edit toolbar ! ! ! developer.mozilla.org/en-US/docs/Project:MDN/ Contributing/Editor_guide
  12. 12. Footer controls
  13. 13. Create a new article
  14. 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. 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. 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. 17. Translations
  18. 18. Translations
  19. 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. 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. 21. What to work on
  22. 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. 23. The aftermath
  24. 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. 25. Thanks! cmills@mozilla.com || @chrisdavidmills fscholz@mozilla.com || @floscholz

×