MDN/Get involved: Difference between revisions

Jump to navigation Jump to search

MDN/Get involved (view source)

Revision as of 19:36, 18 December 2014

4,176 bytes removed ,  18 December 2014
updating for new wiki structure
(updating for new wiki structure)
Line 1: Line 1:
== Report a problem ==
= Join the MDN community =
 
=== Documentation ===
 
Notice a minor problem in documentation? Good news: anyone can edit the MDN! To get started, just click <em>Edit</em> on the article you want to edit.
 
=== Software ===
 
Notice a problem with the underlying software? Have an idea for a new feature? Please [http://mzl.la/mdn-bug share your thoughts] on Bugzilla.
 
== Contribute ==
 
=== Join the MDN community ===
* Introduce yourself
* Introduce yourself
** Join our [https://lists.mozilla.org/listinfo/dev-mdc documentation mailing list].
** Join our [https://lists.mozilla.org/listinfo/dev-mdc documentation mailing list].
Line 20: Line 8:
** [[MDN/Community_meetings|Agenda & minutes]]
** [[MDN/Community_meetings|Agenda & minutes]]
* Meet us at one of our [[MDN/Doc_Sprints|Doc Sprints]].
* Meet us at one of our [[MDN/Doc_Sprints|Doc Sprints]].
=== Writing documentation ===
Anyone can edit the MDN. To get started, just click <em>Edit</em> on the article you want to edit.
Do you want to help with more than a few minor edits? Are you excited by the idea of thousands of web developers reading your work? Great! There are many ways to get involved.
====Editorial review====
One thing beginners can look into is doing editorial reviews. Editorial
review is checking the content for spelling and grammar mistakes and the
likes -- correction of prose, grammar, or content.
Check the list of articles/pages that '''[https://developer.mozilla.org/en-US/docs/needs-review/editorial need editorial review]'''.
Once you complete the review/correction of a page and you are satisfied
with it, you can uncheck "Editorial" in the "Review Needed" section at the
bottom of the page and then save it.
====Technical review====
If you have good understanding of some topic, you can do technical review
of content related to that topic. But make sure you are knowledgeable in
the topic before doing technical review/corrections. When in doubt, always
ask and/or get clarified before doing technical.
Check the list of pages that '''[https://developer.mozilla.org/en-US/docs/needs-review/technical need technical review]'''.
====Adding code samples====
Programmers like writing code more than writing text, so this one is fun!
Say there is an article about the CSS property called <code>border-radius</code> and it doesn't have any examples of how to use that particular property. You can add code samples for it. It's really
cool -- you get to play around with simple code and you get to display it on
MDN. To see what I meant, see the "Examples" section in the [https://developer.mozilla.org/en-US/docs/Web/CSS/border-radius#Examples border-radius page].
If you can think of another creative use of <code>border-radius</code> not listed in the
examples section, go ahead and add it there.
Even better, write examples for features (HTML elements, CSS properties, JS APIs, etc.) that don't have any yet. Look at the list of pages that '''[https://developer.mozilla.org/en-US/docs/tag/NeedsLiveSample need live samples]''' and pick one that seems interesting.
* '''Tip 1:''' Write ''minimal'' code when writing examples.
* '''Tip 2:''' Make sure the sample works!
====Tagging====
Another simple, but important thing to help with is tagging of articles. The
task is to read/skim through articles and adding relevant tags to the page.
Tags help improve the search and discovery mechanism in MDN. What good is a
piece of documentation if it can't be found when needed, right? So this is
way more important than this sounds. More on tagging can be found on the
'''[https://developer.mozilla.org/en-US/docs/Project:MDN/Contributing/Tagging_standards Tagging standards]''' page.
There are other ways you can contribute too. It is highly recommended to
read through the '''[https://developer.mozilla.org/en-US/docs/Project:MDC_style_guide MDN editor guidelines]''' if you are planning to make serious
edits.
=== Translating articles ===
Want to help us translate the MDN into other languages? Great! Follow these simple steps to get started.
# Sign up. Visit the MDN and click <em>Sign in</em> near the top-right of the screen.
# Visit the article that you want to translate.
# Click <em>Languages</em> near the top-right of the screen.
# Choose the language you want to translate to, or click <em>Add translation</em>.
# Write your translation and save!
# We would love to help you. Follow the steps in the [[MDN/Get_involved#Writing_documentation|Writing documentation]] section to introduce yourself.
=== Developing software ===
Want to help with MDN development? Please see our [[MDN/Development/Contribute|developer contribution]] page.
Aspivak
canmove, Confirmed users
842

edits

Retrieved from "https://wiki.mozilla.org/Special:MobileDiff/1042606"

Navigation menu