How to do an editorial review

Editorial review consists of fixing typos and spelling, grammar, usage, or textual errors in an article. Not all contributors are language experts, but due to their knowledge have contributed extremely useful articles, which need copy-editing and proof-reading; this is done in the editorial review.

This article describes how to go about performing an editorial review, thereby helping to ensure that MDN's content is accurate.

What is the task?

Copy-editing and proof-reading of articles that are marked as requiring an editorial review.

Where does it need to be done?

Within specific articles that are marked as requiring an editorial review.

What do you need to know to do the task?

You need to have good English grammar and spelling skills.

What are the steps to do it?

  1. Pick an article to review:
    1. Go to the list of articles needing editorial review.  This lists all the pages for which an editorial review has been requested.
    2. Choose a page that has an English title and whose path doesn't start with  Template:.
    3. Click on the article link to load the page.
  2. Once the page has loaded, click the EDIT button near the top; this puts you into the MDN editor. Don't hesitate to switch to a different page if the first one you choose doesn't suit you.
  3. Correct all typos and spelling, grammar, or usage errors you see.
  4. Enter a Revision Comment at the bottom of the article; something like 'Editorial review: fixed typos, grammar & spelling.'
  5. Click the SAVE CHANGES button.
  6. Once the corrected article appears on-screen after the editor has closed, tick the Editorial entry on the side (under The following reviews have been requested) and click REVIEW COMPLETED.
  7. You're done!


Document Tags and Contributors

Last updated by: chrisdavidmills,
Hide Sidebar