State of the docs, March 2, 2012

To organize and prioritize documentation work on Mozilla Developer Network, we are setting up a system for topic drivers. The person who is the driver for each topic area will prioritize the work for that subject and help ensure that things get written when appropriate. If you’re interested in driving the docs for a particular area, speak up on the dev-mdc mailing list, or in the #devmo channel on irc.mozilla.org. If you have questions about the docs for a particular topic area, seek out that topic’s driver in IRC, e-mail, or Twitter (or ask the community in general if you can’t find that person).

Here’s a sampling of the activity of our splendid documentation community over the past couple of weeks.

Web standards docs

Mozilla technology docs

Mozilla project docs

About Janet Swisher

Janet is the Community Lead and Project Manager for MDN Web Docs. She joined Mozilla in 2010, and has been involved in open source software since 2004 and in technical communication since the 20th century. She lives in Austin, Texas, with her husband and a standard poodle.

More articles by Janet Swisher…


2 comments

  1. Géza

    Hi, this is great!
    Are you going to prune the different wikis, kb-s etc. and pages not maintained over several versions, and kind of standardize?
    I’m even more curious how you will guideline (“shepherded”) that much of people, after all, they are an ‘open source flock’ ;-)
    Maybe, you might add the ‘documentation updated’ as a non-functional criteria for e.g. Q&A.
    Have a nice day!

    March 11th, 2012 at 08:26

  2. Janet Swisher

    Hi Géza,

    You are right that “shepherding” in open source is challenging. Enlisting more people in the effort is one way, which is part of the reason for “topic drivers”. If an area has fallen into neglect, it can be hard to find someone to maintain it. On MDN, we use tags like “NeedsUpdate” to flag outdated content — feel free to add it to pages that need help. We love it when people migrate appropriate content from other sources (wikis or blogs) into MDN. We are working on some degree of standardization, such as adding browser compatibility tables to Web standards reference docs. And while it isn’t a QA requirement, there is a “dev-doc-needed” keyword in Bugzilla to flag code changes that affect documentation on MDN.

    March 11th, 2012 at 12:37

Comments are closed for this article.