Thread:User talk:Aaron Schulz/Having trouble understanding FlaggedRevs configuration and use/reply (3)

Yeah, that documentation is outdated.

The flags determine whether a revision is checked/quality/pristine. These tiers can be queried at UnreviewedPages and PendingChanges (the special pages) to keep the quality/pristine versions up to date. By they are updated "asynchronously". That is newer "checked" versions "go live" before it gets marked as "quality" or better. This reduces the average time for people's edits to get through and simplifies the UI.

The logic to fetch the latest revision of page of the highest level any revision reached is still in the FlaggedRevision::determineStable and FlaggableWikiPage::getBestFlaggedRevId functions and can be used for custom code on your site. Even without custom code, a link to a page with ?stableid=best will show a reviewed version based on this logic.

What I should do is pass getBestFlaggedRevId into the i18n messages for FlaggedRevs, so site admins could edit MediaWiki: namespace pages (which override the message text) to make use of it. For example, someone could use parser functions to check if the "best ID" does not equal the "latest ID", and then show a link to that. (see http://www.mediawiki.org/wiki/Help:Extension:ParserFunctions#.23ifeq).