Confirmed users, Bureaucrats and Sysops emeriti
1,057
edits
Engagement/Developer/Newsletter: Difference between revisions
no edit summary
No edit summary |
No edit summary |
||
| Line 5: | Line 5: | ||
Read more about WPD on the Hacks blog: [https://hacks.mozilla.org/2012/10/welcoming-the-new-kid-web-platform-docs/ Welcoming the new kid: Web Platform Docs]. | Read more about WPD on the Hacks blog: [https://hacks.mozilla.org/2012/10/welcoming-the-new-kid-web-platform-docs/ Welcoming the new kid: Web Platform Docs]. | ||
===Improving our Documentation Processes=== | |||
We have a couple of things we're working on to help improve our documentation processes, and we need your help! | |||
====Proposing a New Documentation Process for Mozilla==== | |||
As Mozilla has grown, the number of things needing developer documentation has skyrocketed, and the docs team can no longer keep up! In order to streamline our process for determining what needs to be written about and when, we have [http://www.bitstampede.com/2012/10/05/proposed-new-documentation-process-for-mozilla/ proposed a new documentation process] which will require the development teams and writing team to work more closely together in the future. | |||
If you're a Mozilla developer, you <strong>need</strong> to [http://www.bitstampede.com/2012/10/05/proposed-new-documentation-process-for-mozilla/ read this blog post] and [https://developer.mozilla.org/en-US/docs/Project:Documentation_process the corresponding proposal]. Be sure to comment on the blog post or [mailto:eshepherd@mozilla.com email the developer documentation team lead] with your feedback. | |||
====Looking for Subject Matter Experts==== | |||
It’s rare, when writing documentation, that questions don’t arise. When writing documentation, we try to avoid hassling the engineers with questions, but it’s almost inevitable that we’ll run into something we’re not able to figure out on our own. When that happens, we need to know who to contact with our question. | |||
And, all too often, we have no clue at all who we should reach out to. We’ll ask blindly on IRC and sometimes (but not as often as we’d like) get the answer we seek. Then we’ll ask on mailing lists. Often that’s a dead end. Then we resort to emailing people at random until the answer is found. | |||
If you can [https://developer.mozilla.org/en-US/docs/Project:Subject-matter_experts help build this list] to ensure that we can find the right people to talk to when we have questions about a technology, you can not only improve the writing team's ability to get its job done, but you'll help us improve the quality of the documentation about your hard work! | |||
<h2>August 2012</h2> | <h2>August 2012</h2> | ||