WTD Podcast Episode 11: Exploring the Mozilla Developer Network's Web Docs project
Here are some of the questions discussed during the podcast:
- What motivations do participants have for contributing to MDN docs?
- How does MDN’s web doc initiative differ from Stack Overflow’s documentation project?
- How does MDN’s web docs differ from documentation on W3C Schools?
- What reasoning is behind the decision to use wiki platforms instead of GitHub repos?
- How are you integrating into web dev IDEs to provide real-time linting/validation during coding?
- How does conceptual documentation differ from action-oriented documentation, and which is more suitable for the web developer audience?
- How can users contribute to the MDN?
- How do you manage all the volunteers and edits across thousands of MDN pages?
- How do you keep the project funded?
- What’s the ultimate goal of the MDN documentation?
For more detail, see Mozilla brings Microsoft, Google, the W3C, Samsung together to create cross-browser documentation on MDN. In this article, the authors note:
In this year alone, 8,021 users made 76,203 edits, greatly increasing the scope and quality of the content. Cross-browser documentation contributions include input from writers at Google and Microsoft; Microsoft writers have made more than 5,000 edits so far in 2017.
I'd Rather Be Writing Newsletter
Get new posts delivered straight to your inbox.
About Tom Johnson
I'm a technical writer based in the California San Francisco Bay area. In this blog, I write about topics related to technical communication — Swagger, agile, trends, learning, plain language, quick reference guides, tech comm careers, academics, and more. I'm interested in simplifying complexity, API documentation, visual communication, information architecture and findability, and more. If you're a technical writer of any kind (progressional, transitioning, student), be sure to subscribe to email updates using the form above. You can learn more about me here. You can also contact me with questions.