The revision dashboard is a feature of the Mozilla Developer Network wiki which lets you look at recent revisions and additions to content on MDN, examine details of what was changed, and act upon those revisions in various ways. This article is a guide to using the revision dashboard.
The revision dashboard has a busy interface with tons of handy features, so let's start with an overview of the interface's primary sections.
The most important things to note here are the revision list, which lets you browse through revisions matching your filter, and the revision diff, which shows the changes made in the revision you click on.
The revision list
The revision list in the middle of the revision dashboard window provides a list of changes that have been made recently. The list is ordered with the most-recently changed article first, progressing toward older and older revisions.
Immediately below the revision list is an indicator telling you how many total pages match your query and which of them you're currently viewing. If you haven't filtered anything out, you'll see the total number of revisions that have ever been made to the MDN wiki.
Each row in the list corresponds to a single change to the wiki. A "change" consists of any one or more of the following:
- A new page was created. These are indicated with "New:" before the name of the article.
- A page was moved. This is indicated with a small box under the article name that says "Moved from <old path> to <new path>".
- The text of a page was changed.
- The page's tags were changed.
- A page was deleted. Unimplemented
Each row has three columns: Article, Date, and Author.
The article column gives you information about the article that was changed. This column offers several bits of information:
- Article title
- The first thing in the row is the article's title. This is also a link to the article in the wiki, so you can go look at it directly quickly and easily. If the article is new, the text "New:" is displayed before the article's name.
- The article's locale is indicated at the top-right corner of each row in this column. This is displayed as the language shortcode, such as "en-US" for US English.
- Revision comment
- Below the article's title is the revision comment, if there was one added when the change was saved. This is displayed in smaller, italicized text.
- Move information
- Beneath everything else is—if applicable—displayed a box telling you the source and destination paths on the wiki if the page was moved during the revision.
To view a diff showing what changed in a given revision, click on the revision's row in the list (anywhere that isn't a link to other content). This will display the page's diff in the "Revision Diff" area at the bottom of the page.
The date column simply tells you the date and time the revision was saved. Nothing more.
The author column lists the username of the person that saved the revision. You can click the name to quickly filter on that user.
MDN provides several helpful filtering options that you can use to reduce the amount of "stuff" you see in the revision list based on your needs. There are three filters available:
- You may filter so that you only see changes in a specific locale. By default, you see changes across all locales, but this may not be useful to you. Indeed, if you're a member of a localization team, for example, the only locales you're likely to care about are your own and English. You can specify the locale to filter by in the URL when going to the revision dashboard by adding "locale=<localename>" to the query string. For example: https://developer.mozilla.org/en-US/dashboards/revisions?locale=en-US filters to show only changes to English documents.
- Interested in what a specific user has been up to? You can look at the revisions submitted by a single user by entering it in this field. You can specify a user in the URL when going to the revision dashboard by adding "user=<username>" to the query string. For example, you can see changes by the user Sheppy with https://developer.mozilla.org/en-US/dashboards/revisions?user=Sheppy. This box will offer suggestions as you type, to help you find exactly the person you're looking for.
Once you've configured your filter, click the "Filter" button to apply it; after a few moments, the display will update with your filtered results.
The revision diff
The diff display is a pretty standard difference display, showing the changes in the underlying HTML between the two revisions. We hope to eventually offer support for diffing only the displayed text, to help more quickly do editorial reviews of changes, but for now this is what we have.