Help:Extension:FlaggedRevs/it

è un'estensione del software MediaWiki che permette il controllo dei cambiamenti che vengono effettuati sulle pagine, e di controllare più attentamente i contenuti che vengono mostrati ai lettori della wiki. Alle pagine vengono impostate delle variabili, dette flag, da utenti con determinati requisiti detti "editors" e "reviewers" per segnalare che le pagine in questione sono state controllate e rispondono a determinati criteri che la wiki ha stabilito. Ad ogni versione successiva della pagina può essere impostata una flag dagli utenti che controllano il contenuto della modifica. Una wiki può usare una scala di queste variabili flag, con solo determinati utenti a cui è permesso assegnare determinate flag.

La possibilità di assegnare un flag alle modifiche rende più facile coordinare l'attività di manutenzione di una wiki, dato che rende più evidente quali sono le nuove modifiche (potenzialmente dannose) e quali sono invece state accettate come migliorative. E' possibile, tuttavia, configurare le pagine in modo che solo le modifiche a cui è stata assegnata una flag di un determinato livello siano visibili ai lettori; così, le versioni modificate dagli utenti con un livello inferiore a quello assegnato alla pagina rimangono in bozza finché la loro modifica non viene convalidata da un altro utente dotato del livello sufficiente.

FlaggedRevs è estremamente flessibile e può essere usato in un'ampia gamma di configurazioni diverse, può essere molto discreto, tanto da essere quasi invisibile o può essere usato per controllare molto rigidamente l'attività di una wiki.

Terminologia
FlaggedRevs introduce alcuni nuovi termini riferiti agli utenti ed alle modifiche. Mentre ogni termine è completamente configurabile per adattarlo alle differenze di lingua o della specifica wiki, alcuni termini rimangono universali.
 * Flag ed assegnare un Flag

FlaggedRevs permette ad una wiki di definire delle variabili dette "flag" che possono essere applicate alle modifiche di una pagina per indicarne la qualità od altri attributi di quella versione modificata. I Flag sono raggruppati in scale gerarchiche dove alcune wiki potranno usarne una sola mentre altre potranno configurare diverse scale per indicare differenti attributi delle pagine. Per esempio, la configurazione standard di FlaggedRevs definisce tre scale, "Accuratezza", "Profondità" e "Leggibilità", con ognuna di esse formata da quattro flag.


 * Marker o marcatore

I marker (marcatori) sono raggruppamenti più astratti di variabili flag che identificano articoli che appartengono ad una particolare qualità. Ci sono tre marker disponibili, "checked" (controllato), "quality" (qualità) e "pristine" (intatto). Di base ogni modifica a cui sia stato assegnato un flag di qualsiasi livello appartiene al marker "reviewed" (esaminato). Il livello base del "quality" marker è livello-uno di accuratezza e completezza e livello-due di leggibilità. Per il marker "pristine" una versione deve essere esaminata la massimo livello su tutte e tre le scale della qualità. La maggior parte delle wiki definiscono le proprie scale di qualità e queste configurazioni possono essere variate.


 * Versione stabile e corrente

Una pagina su cui sia stata attivata l'estensione FlaggedRevs è disponibile in due versioni: la "current version", versione corrente e la "stable version" versione stabile.

Current version Versione corrente
 * La versione corrente è, evidentemente, la versione più recente della pagina che comprende le modifiche più recenti indipendentemente se queste siano o meno migliorative.
 * La versione corrente è anche definita bozza della pagina.

Stable version Versione stabile
 * La versione stabile è la versione più recente della pagina che sia stata esaminata

Si può sempre collegarsi direttamente alla versione corrente o stabile della pagina aggiungendo rispettivamente &stable=0 o &stable=1 all'url della pagina.

Visualizzazione


La FlaggedRevs permette ad una wiki di segnare ogni versione della pagina con una variabile, flag, per indicarne la qualità o validità, e per controllare quali versioni siano visibili della pagina stessa. Ogni pagina in cui la FlaggedRevs è attivata è effettivamente fornita in due versioni; la versione "stabile", che è l'ultima versione a cui sia stata assegnata una variabile flag di livello sufficientemente alto, e la versione "corrente", che è la versione più recente, dotata o meno di un flag. I lettori possono accedere ad entrambe le versioni della pagina aggiungendo &stable= all'URL nella casella dell'indirizzo web della pagina, impostando &stable=0 per la versione corrente, e &stable=1 per la versione stabile. Su di entrambe le versioni c'è un avviso ed un collegamento all'altra versione.

Gli sviluppatori di una wiki possono impostare quale versione sia visibile agli editori ed ai lettori, e quali variabili flag permettano ad una versione di essere considerata 'stabile'. Gli utenti registrati possono impostare quale versione delle pagine sia visibile normalmente modificando le proprie Preferenze. Gli editori sono avvisati di quale versione stanno visualizzando dalla linguetta "", che invece visualizza.

Modifica


La FlaggedRevs non influisce sulla possibilità degli utenta di modificare le pagine; cambia solamente come la wiki utilizza i cambiamenti. Ogni qualvolta un utente modifica una pagina, il contenuto del riquadro di modifica è sempre il wikicodice della versione corrente, per impedire l'accumulo di versioni alternative. Quando ci sono cambiamenti non verificati dall'ultima versione stabile, una differenza tra le modifiche è visualizzata sopra la finestra di modifica per evidenziare tali modifiche. Questo è importante poiché il testo che viene modificata potrebbe non essere lo stesso che l'utente vede prima di seguire il link "" (se l'utente stava visualizzando la versione stabile); e permette che ogni cambiamento sia verificato, modificato o annullato se necessario.



Se l'utente non sarà in grado di vedere le proprie modifiche nella versione in visualizzazione standard, un messaggio di avviso ulteriore viene visualizzato,. A parte questo, il processo di modifica non viene cambiato da FlaggedRevs; le modifiche sono fatte, viste in anteprima e salvate normalmente.

Gli utenti che hanno i requisiti per verificare le modifiche sono incoraggiati a farlo sia durante che dopo le loro modifiche. C'è un opzione in più accanto ai box di spunta "" e "" per verificare immediatamente la versione editata, comunque questa opzione non è normalmente selezionata. Quando un utente con funzioni di rewiewer, revisore, effettua una modifica viene indirizzato all'articolo come avviene usualmente, ma viene presentata anche una differenza tra le versioni, comprese le sue modifiche, dall'ultima versione stabile, con la possibilità di immediatamente verificare i cambiamenti.

Verifica


Reviewing versions is the primary new activity introduced by FlaggedRevs. With the exception of the "review this edit" checkbox on the edit screen, all methods of reviewing versions use the same interface. At the bottom of a draft page, a series of radio buttons or checkboxes allows the reviewer to select which flags to apply to the revision, and there is the option to provide a comment that will appear in the review log.

Users can review any version, including versions that have already been reviewed by others. In this instance the newest review overrides previous reviews: if the new reviewer flags the version at a higher level than the previous reviewer, it is considered a normal "approve" review, while 'confirming' another reviewer's assessment by flagging the version to the same level is recorded as a "re-review". By flagging a previously-reviewed version as 'unassessed', reviewers can effectively 'unflag' a revision; these "deprecations" can be seen in a separate stream in.

Finding unreviewed versions
FlaggedRevs is designed to encourage eligible editors to review versions quickly and efficiently, and so links are provided in most common locations to review changes by editors who cannot flag the versions themselves. Edits that have resulted in an unreviewed version are marked with an exclamation mark ! in the watchlist and the RecentChanges feed, with a link to review the changes. When viewing a page that has unreviewed edits, a banner is also added to indicate the number of edits since the last stable version, the age of the stable version, and a link to review the changes.



The FlaggedRevs extension also creates a number of new special pages that can be used to find and manage reviewed and unreviewed pages:


 *  - pages which have a stable version


 * ' (called ' on some wikis) - pages that have pending changes from the stable version.


 *  - pages that have pending changes from the stable version that also have recent changes tags.


 *  - pages that have no reviewed stable version.

The latter two pages also include the number of users who have each page on their watchlist, so that 'backwater' articles can be identified and monitored; because of this slightly sensitive information, access to pages is usually restricted to users who have the ability to review versions. is sorted by the time since the last revision was flagged, oldest first.

General oversight
In addition to these pages, several other reports give general oversight over the reviewing process. is a list of pages where the default display settings have been overridden by administrators to either always show readers the "stable" alias by default or always show readers the "current" alias by default, depending on the wiki's FlaggedRevs settings.

 provides an aggregated log of all reviews made on the wiki. These events are also added in a new 'stream' to the main log at Special:Log, at Special:Log/review. However, the report at can be filtered by marker type, namespace, whether the action was to review, unreview or re-review the revision, and whether the review was automatic or manual.

Finally,  provides a summary of how thoroughly each content namespace has been reviewed, and other useful data about the reviewing process.

Autopromotion
Wikis can configure FlaggedRevs to automatically grant editors the ability to review versions when they meet certain thresholds of activity. Wikis need to judge carefully how best to configure the autopromotion feature (if at all) to be as confident as possible that the user is a constructive editor, without making them wait too long to be promoted. Thresholds can be set on a number of attributes, including:


 * How old the user's account is (number of days since they registered)


 * Their total editcount
 * It can be required that these edits have been made consistently over a time period, eg 20 edits spread over a period of 20 days would qualify, but 20 edits all at once would not
 * Edits from the last X days can be excluded from the count (giving admins time to look at them)
 * A certain number of these edits can also be required to be in "content" namespaces


 * The number of separate content pages the user has edited


 * The number of edits the user has made that include an edit summary
 * Whether the user has a user page, and how substantial it is (bytecount)


 * Whether the user has ever been blocked


 * The number of reverted edits the user has (not counting self-reverts)


 * How many times the user made an edit summary (including automatic ones)

The autopromotion mechanism can be overridden by administrators, either to promote a user who does not meet the criteria, or to demote a user who has abused the reviewing ability.

Administrators' abilities


While a wiki's developers can define default settings for which alias is presented to each user group by default, these settings can be customized by individual users and for individual pages. Each registered user can set in their preferences whether they wish to see the "current" or "stable" alias by default when viewing an article.

Some group on the wiki, usually administrators, have the ability to use the special page  to override the default display for unregistered users. Administrators can set a page to display the stable version by default, and can also control how the stable version is selected, choosing which marker is preferred.

Administrators also have the ability to grant users the ability to review edits, and to revoke that permission in case of abuse, by using the Special:UserRights interface. This explicit assignment overrides any permissions automatically given to the user by the autopromote feature – if an administrator has explicitly revoked a user's reviewing permissions, the autopromote feature will not grant them back, and vice versa.