Help talk:Extension:FlaggedRevs

Since a lot of people editing this particular help page are not active on mediawiki.org generally, there are a few special considerations here that don't apply anywhere else. First and foremost, remember that the edits you make to the help page are released into the public domain, so anyone can use them for any purpose. If you don't want that, don't edit :D. Secondly, remember that this documentation must be "site-neutral": this is the main website for all X many thousands of wiki installations on the web, not just wikimedia, and not just wikipedia. As such, we need to avoid wikipedia-specific content: no links to en.wiki discussions, and avoid wikipedia-specific terminology, even things like NPOV and BLP: other wikis might not have the same considerations. This is supposed to be a completely neutral explanation of how the system works, not how it might be used.

By far the most important thing is to get the content actually on the page; style and presentation issues can be resolved later. Remember that this should be aimed mainly at the lay-user: an editor who is aware of how to edit but knows nothing of the intricacies of the MediaWiki interface. Obviously this general rule needs to bend a bit in cases: when talking about how FlaggedRevs affects the recent changes feed, naturally we assume that the reader of that section knows what the recent changes feed is. Similarly the section describing admin actions is aimed at administrators. But in general, pitch the documentation at the lowest level that's sensible.

Much can be gleaned from the implementations currently in operation on Wikimedia, including en.labs, test.wiki and de.wiki (although remember that all content, including screenshots should be in English). There is also loads of information available to those who can read the appropriate 'language', at the manual here, the source code on SVN, the Wikimedia config files, and all over en.wiki. Don't hesitate to raise any questions here or elsewhere; hopefully this can be a learning process for all of us.

Many thanks in advance for any assistance you can provide, Happy ‑ melon 19:03, 28 January 2009 (UTC)

en.labs
It is safe to say the the version of FlaggedRevs running of en.labs is the default MediaWiki version? Dbiel 21:37, 28 January 2009 (UTC)
 * Yes, certainly for now. Happy ‑ melon 22:21, 28 January 2009 (UTC)

FlaggedRevs software and MediaWiki
Is FlaggedRevs currently running on MediaWiki? It would be helpful to be able to link to some pages to show some of the default views as they relate to FlaggedRevs. Dbiel 22:07, 28 January 2009 (UTC)
 * Unfortunately not, so the special pages eg Special:OldReviewedPages, don't exist here. Screenshots would be very helpful; there are quite a few already uploaded - have a look at the manual page and see what we can pinch; you can link images from commons here too so we can use anything from over there. Happy ‑ melon 22:21, 28 January 2009 (UTC)

This is difficult
Since everything is customizable, it may not be possible to write this to the level of the average user and remain "site-neutral". You have to use examples, which by their basic nature are not "site-neutral".

I have attempted to list some terms used, but am finding that the terms themselves are not "site-neutral". Dbiel 03:07, 29 January 2009 (UTC)

User Groups
Since user groups appear to be site specific it is hard to come up with non site specific names

The following is copied from http://en.labs.wikimedia.org/wiki/Special:ListGroupRights

Reviewers

 * Automatically mark revisions as sighted (autoreview)
 * Automatically mark revisions in non-main namespaces patrolled (autopatrolother)
 * Edit semi-protected pages (autoconfirmed)
 * Mark others' edits as patrolled (patrol)
 * Mark revisions as sighted (review)
 * View list of unreviewed pages (unreviewedpages)

Uber-Reviewers

 * Mark revisions as sighted (review)
 * Mark revisions as validated (validate)

autoreview

 * Automatically mark revisions as sighted (autoreview)

New copy
I have decided to work on a copy at http://en.labs.wikimedia.org/wiki/Help:FlaggedRevs where I can be site specific, link to pages and actually test things to make sure it makes sense which just can not be done here or in en.Wikipedia at this time as the software is not running in either of those two wikis at this time. Dbiel 04:30, 29 January 2009 (UTC)
 * That's probably a good idea; as you point out above, being able to link to the special pages etc is very helpful. And en.labs needs documentation anyway, and there it needs to be site-specific.  Would you mind releasing your edits there into the public domain so any relevant material can be copied between these two pages? Happy ‑ melon 14:29, 29 January 2009 (UTC)
 * Editor (sighting) & Reviewer (Quality), more logical would be Sreviewer and Qreviewer, call a spade a spade, no problem to convert it on a dev level, its confusing. Mion 14:37, 29 January 2009 (UTC)

Surveyors (administrators)
Strange group. As it is written now, it seems indistinguishable from 'reviewers'. Ruslik0 18:39, 29 January 2009 (UTC)