MDN technical writer contractor (applications closed)

Important: This position has now been filled, so applications are now closed. Please do not apply for this position!


April 27th, 2018

Issued by: Mozilla

Mozilla Representative: Chris Mills,, MDN writers' team manager

  • Location: US, Canada (relocation not possible)
  • Home working possible: Yes

Important: This is a full-time contract position with the employment handled through an agency, not a permanent job at Mozilla.


MDN Web Docs is a premier technical reference for web developers, with over 7 million global users and 1,000 volunteer content contributors per month working to help make a better web. Web developers love MDN, and we are looking for an experienced technical writer with a web developer background (or a web developer with a technical writing background!) who can help us continue to deliver the best possible content for developers.

Technical writers take complex information and communicate it clearly and accurately,  understand how developers think and what information they need, work well with engineers, and have a deep understanding of software development tools and practices. In this role, the technical writer documents technical information related to web development and the open web, writes code samples and tutorials, and keeps updated on the state of web standards and developing technologies.

The MDN Technical Writer also participates as a stakeholder in product and platform development and works with a large global community of contributors who are passionate about the web. MDN technical writers have experience as developers (preferably web) and can read and write code (primarily JavaScript, HTML, & CSS).


  • Write technical documentation and resources for developers, such as reference docs, guides, and tutorials.
  • Create sample code and demos.
  • Obtain source information from documented web standards, internal project documentation & bugs, and interviews with project engineers and team members.
  • Solicit technical and editorial reviews and incorporate feedback.
  • Help triage and prioritize documentation bugs. Write documentation based on bug information. Update documentation bugs (Bugzilla) with status.
  • Provide feedback on, edit, clarify, and proofread documents written by others.
  • Participate in agile team processes, such as standups, user story creation, and planning sessions. Help define user stories, acceptance criteria, and tasks.
  • Identify gaps in current developer documentation and propose for prioritization.
  • Provide feedback on content strategy and roadmap.
  • Suggest improvements to the MDN platform that facilitate user success and content production.
  • Interact actively and positively with a volunteer community of writers, developers and translators.
  • Contribute content to social media and newsletters.


  • At least 2 years of relevant experience researching and writing documentation, code examples, and demos for web developers.
  • Experience coding with JavaScript, browser APIs, CSS, and HTML.
  • Experience using Git and Github.
  • Familiarity with bug tracking software (e.g. Bugzilla).
  • Familiarity with Agile and/or SCRUM methodologies.
  • Can read and understand technical specifications (e.g. W3C or TC39 specs)
  • Ability to publish information using HTML, wikis, and other online collaborative technologies.
  • Ability to cope with fast-paced and constantly changing environments.
  • Able to write clearly in English, but English doesn’t need to be your first language.
  • Experience writing guides/tutorials and API reference documentation.
  • Ability to work with a geographically distributed team of employees and volunteers.


  • Experience working with open source communities, extra bonus if you have contributed to MDN and/or Mozilla.
  • Experience with modern web development workflows (using linters, etc.)
  • Experience with localization, and knowledge of other languages besides English.
  • Experience with low-level systems code such as C++, Rust, or Java.

To apply

Send an email to Chris Mills, MDN writers' team manager, at Include your CV/Resumé, a cover letter explaining why you'd be a good fit for the job, and any other supporting information you think might be useful.