Revision dashboard guide

by 2 contributors:

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.

First look

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.

Screenshot of revision dashboard with labeled UX areas

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.

Article column

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.
Locale
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.

Date column

The date column simply tells you the date and time the revision was saved. Nothing more.

Author column

The author column lists the username of the person that saved the revision. You can click the name to quickly filter on that user.

Filtering

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:

Locale
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.
User
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.
Topic
If you'd like to see changes only about a given topic area, you can specify a topic string. This will be matched against the URLs of articles that have been changed and show only those whose titles include this string. You can specify the parameter "topic=<topic>" in the URL's query string to filter on this, as well. For example, if you'd like to see only JavaScript-related changes: https://developer.mozilla.org/en-US/dashboards/revisions?topic=JavaScript.

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.

It's also worth noting that you can use these filters together, either in the user interface or in the URL's query string, so you can do fairly intricate searches. For example, to find only changes made to English articles about JavaScript that were made by the user evilpie, you can use https://developer.mozilla.org/en-US/dashboards/revisions?locale=en-US&user=evilpie&topic=JavaScript.

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.

See also

Document Tags and Contributors

Tags: 
Contributors to this page: Sheppy, jswisher
Last updated by: Sheppy,
Hide Sidebar