5. You can
⢠Shine
⢠Get sex, drugs and rock ânâ roll
⢠Get stickers, t-shirts and recognition
⢠Help the community get the docs they need
Monday, 14 October 13
6. Your project can
⢠Get internal and external visibility
⢠Get promotion (in combination with Hacks blog,
evangelist talks, etc.)
⢠Get more users and contributors
Monday, 14 October 13
7. Mozillians, the whole world
⢠Gets awesome docs to help them do their work
⢠Is able to contribute back
⢠Will get to know you and love you
Monday, 14 October 13
8. Itâs a great platform
⢠Kuma â based on Django and Node.js
⢠Itâs a Wiki, on steroids
⢠Our development team are *actually*
ninjas.
Monday, 14 October 13
10. You just have to log in...
⢠This is mainly just to cut down on some spam
⢠And to share recognition, and blame!
⢠We use Persona
Monday, 14 October 13
11. Once logged in
⢠You can edit pages
⢠Create new pages
Monday, 14 October 13
12. 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 #devmo)
Monday, 14 October 13
14. 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 stuďŹ than send us bugs!
Monday, 14 October 13
18. 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
Monday, 14 October 13
20. Big or small
⢠Itâs all really useful!
⢠Some MDN contributors literally just make a handful
of small ďŹxes each day, or week
⢠But it improves the site quality enormously
Monday, 14 October 13
21. Small contributions
⢠Typos
⢠Correction of technical errors
⢠Title ďŹxes
⢠Adding tags
⢠Code consistency ďŹxes
⢠Code snippets
Monday, 14 October 13
22. Small contributions
⢠Improving descriptions and examples
⢠Proof reading, tech review
⢠Macro ďŹxes
⢠Other minutiae
⢠Feedback!
Monday, 14 October 13
23. Large contributions
⢠Writing new articles
⢠Tech editing/copy editing
⢠Translations
⢠Writing demos
⢠Kuma development
⢠Writing tools
Monday, 14 October 13
25. Write it...
⢠Then request an edit
⢠You can also ask on the mailing list or in IRC
Monday, 14 October 13
26. Shout about it!
⢠Spread the word on Twitter, Google+, etc.
⢠Get developers interested in using the feature/tool/
whatever it is, and contributing to the docs
Monday, 14 October 13
27. Tech/copy editing
⢠Can be a big task, depending on the quality or length
of writing
⢠Make most ďŹxes yourself
⢠For uncertainties, contact the main contributor
⢠Ask on IRC/mail
⢠File a bug
Monday, 14 October 13
32. Collaborate!
⢠Start a localization group
⢠Or join an existing one
⢠developer.mozilla.org/en-US/docs/Project:MDN/
Localizing/Localization_projects
Monday, 14 October 13
33. Write demos
⢠Some people donât like writing prose
⢠But excel at writing code
⢠Good demos are a major plus
Monday, 14 October 13
34. How to add demos
⢠Put them on Github
⢠Directly, or via JSBin, Codepen.io, etc.
⢠Link to them!
Monday, 14 October 13
35. Live samples
⢠Smaller samples can be put directly on the Wiki page
⢠Then assembled into a running demo
⢠developer.mozilla.org/en-US/docs/Project:MDN/
Contributing/Editor_guide/
#Using_the_live_sample_system
Monday, 14 October 13
36. Write tools
⢠Why not write a demo that does something useful?
⢠For example, the box-shadow generator
⢠developer.mozilla.org/en-US/docs/Web/CSS/Tools/
Box-shadow_generator
Monday, 14 October 13
37. Write macros
⢠A macro is basically just a special kind of page
⢠developer.mozilla.org/en-US/docs/
Template:HTMLElement
⢠In this page you enter KumaScript, which is basically
JS with some extra APIs
Monday, 14 October 13
38. Write macros
⢠This JS is executed server-side
⢠So you canât do client-side type stuďŹ with it
⢠But you can automate a lot of work!
⢠https://developer.mozilla.org/en-US/docs/
Project:MDN/Contributing/Custom_macros
Monday, 14 October 13
39. Kuma development
⢠If you are a ninja (or at least a samurai, or pirate)
⢠You might want to help develop the system
⢠Itâs on github
⢠github.com/mozilla/kuma
⢠developer.mozilla.org/en-US/docs/Project:MDN/
Kuma/Contributing
Monday, 14 October 13
40. Itâs a big community
out there
Monday, 14 October 13
41. CommUNITY
⢠Donât feel you have to do it alone
⢠Find others who share your immediate interests
⢠And collaborate
⢠Ask for help on IRC, mail
Monday, 14 October 13
45. Notes for session presenters
When running a workshop on MDN editing:
⢠Start with a presentation, including what you need to
know to become an MDN contributor (slides 9-35?)
⢠Make sure everyone can sign in, and ďŹnd a page for
them to edit.
Monday, 14 October 13
46. Notes for session presenters
When running a workshop on MDN editing:
⢠Bookmark several pages containing simple-to-ďŹx
problems.
⢠Let people choose one of these to ďŹx (unless they
want to ďŹnd something of their own).
Monday, 14 October 13