This page is for Devmo users who wish to contribute to the Devmo project. It explains what you need to do to become a contributor and how you can help the project.
First, quick links to the lists of documentation we need to write or migrate:
- MDC:Documentation Wishlist
- Mozilla.org Existing Content List
- MDC:Articles and Tutorials Sign-up List
You can also look at the categories listed on MDC:To Do List.
Create an Account for yourself
Simply click the Create Account link and fill in the blanks. You have to create an account and login in order to edit pages. This is because it helps fighting vandalism and makes it easier to track (and give credit for) your contributions.
Sign up to the devmo-general Mailing List
Before you get started, it's recommended that you sign up to the devmo-general mailing list. All project questions, communication, and coordination are handled through the list, so it's fairly essential that all Devmo contributors are signed up there.
Information about the mailing list, as well as about other places, like the #devmo IRC channel, is available at the MDC:Community page.
How you can help
Migrating DevEdge content to the Devmo Wiki
Third, check out the DevEdge:Priority Content list. The priority DevEdge content we want migrated into the wiki is listed there, with links to the temporary mirror site we've set up. If you see something there you would like to migrate into the wiki, "Edit" the Priority Content list and put your name beside title. If someone else has already signed up for it, try to contact that person to offer to help with it, so you can coordinate your efforts.
When you have signed up to help with migrating a piece of content, send a note to the devmo-general mailing list telling us who you are and which piece you are going to be working on. This just helps us keep track of what's going on.
Finally, go to the "stub page" that we've created for that content in the wiki, hit "Edit" and get started. When you're finished, or if you have any problems or questions, just send a note to the mailing list.
Contributing new content
Contributing new content to the Devmo wiki is one of the most valuable ways you can help, whether that new content be a whole new book-length piece, or a small-but-well-documented code sample added to an existing page. We love new content.
If you would like to contribute new content, the procedure is pretty straightforward:
Third, if your content is an addition to an existing page, simply click "Edit" on that page and add your content, marking it up as best you can.
If your content is new and requires a new page, simply decide where it would best fit within the existing wiki, add a link that points to the new page, then click on that link to create and edit your content.
2) I'd then add my article title to the list in that section surrounded by the same wiki-link tags as the rest of the articles, like:
After adding your new content, it's usually a good idea to send a note to the devmo-general mailing list. This will let the rest of the contributors know that there's new content so we can then help with reviewing, editing, and making sure it's in the best location.
Doing technical reviews
If you're a technical expert in any particular area covered by our documentation, your expertise would be very much appreciated in doing technical reviews of the content that exists within the wiki.
Everyone makes mistakes, and no one knows all of the best ways to do everything, so the more eyes we have going over our documentation for technical accuracy and best-practices, the better.
If you find a page that contains technical errors or that could be improved, simply click the "Edit" tab and make whatever changes you see fit. If you need help with markup, there's a Devmo Wiki Markup Reference you can reference. Once you're finished making changes, simply "Save" the page to commit those changes to the site.
This category contains articles marked as needing a technical review: Category:NeedsTechnicalReview.
Doing editorial reviews
If you have a strong command of language, grammar, spelling, and writing, your expertise could be best used by editing and improving the overall writing quality of the content in this wiki.
Sometimes writing about technical subjects can be awkward due to the emphasis on accuracy over writing style, so be sure that any changes you make to the writing do not change the technical information being communicated. If you're not sure, feel free to bring it up on the devmo-general mailing list.
Should you find areas that need improvements or fixes (typos, spelling, grammar, clarity, etc) simply click on the "Edit" tab at the top of the page, make whatever changes you see fit, then hit "Save" to commit those changes to the website.
This category contains articles marked as needing an editorial review: Category:NeedsEditorialReview.
Devmo now has several wikis set up to support translation projects.
Ideally, we would like to have all of our documentation translated to as many languages as possible. If you would like to work on translating to a language not listed here, send email to Deb Richardson, and she'll make sure that a new wiki is set up for you.
Help Redesign the Devmo Wiki Theme
The current theme is not necessarily final, so if you have suggestions about what could be improved, please post them on MDC:Theme Change Suggestions.