Help:Reverting

''This is an adaptation of the master help page at Meta.Wikimedia.org. Do not edit this copy.'' ''Edits will be lost in the next update from the master page. See below for more information.''

To revert is to undo all changes made to an article page after a specific time in the past. The result will be that the page becomes identical in content to the page saved at that time. However in the context of SourceWatch, a revert is defined far more broadly as any change to an article that partially or completely goes back to any older version of an article.

A partial revert is accomplished either by an ordinary edit of the current version, or by editing an old version. The former is convenient, for example, for a partial reversion of a recent addition, while the latter is convenient for a partial reversion of a deletion.

Some SourceWatch-oriented text is at the bottom of the page.

Dos

 * Reverting is a decision which should be taken seriously.
 * Reverting is used primarily for fighting vandalism, or anything very similar to the effects of vandalism.
 * If you are not sure whether a revert is appropriate, discuss it first rather than immediately reverting or deleting it.
 * If you feel the edit is unsatisfactory, improve it rather than simply reverting or deleting it.
 * You can revert your own edit if you realize that it is wrong (you should have noticed this in the preview, though). Be careful if some other editor has made changes in the interim.

Don'ts

 * Do not simply revert changes that are made as part of a dispute. Be respectful to other editors, their contributions and their points of view.
 * Do not revert good faith edits. In other words, try to consider the editor "on the other end." If what one is attempting is a positive contribution to SourceWatch, a revert of those contributions is inappropriate unless, and only unless, you as an editor possess firm, substantive, and objective proof to the contrary. Mere disagreement is not such proof.
 * If the edit you are considering reverting can instead be improved (for example, to avoid weasel words, then reword, don't revert.
 * Generally there are misconceptions that problematic sections of an article or recent changes are the reasons for reverting or deletion. If they contain valid information, these texts should simply be edited and improved accordingly. Reverting is not a decision which should be taken lightly.
 * There's sometimes trouble determining whether some claim is true or useful, particularly when there are few people "on board" who are knowledgeable about the topic. In such a case, it's a good idea to raise objections on a talk page; if one has some reason to believe that the author of what appears to be biased material will not be induced to change it, editors have sometimes taken the step of transferring the text in question to the talk page itself, thus not deleting it entirely. This action should be taken more or less as a last resort, never as a way of punishing people who have written something biased.

How to revert

 * Go to the page, click on "history" at the top ("Page history" in some skins), and click on the time and date of the earlier version to which you wish to revert.
 * Then when that page comes up, you'll see something like "(Revision as of 22:19 Aug 15, 2002)" below the article title.
 * Verify that you've selected the correct version, and click to edit the page, as you would normally. Important: in the case of vandalism, take the time to make sure that you are reverting to the last version without the vandalism; there may be multiple consecutive vandal edits, sometimes interspersed with constructive edits.
 * You'll get a warning, above the edit box, about editing an out-of-date revision.
 * After heeding the warning, save the page. Be sure to add the word "revert" and a brief explanation for the revert to the edit summary (the box below the editing window). A useful addition is to Wikilink the usernames associated with the versions you are reverting from and to. For example, a good edit summary when reverting vandalism would be rv edits by Tim Malacarne to last version by Conor Kenny The clickable links are created by entering  Username  (replacing Username with the real Username).
 * Click on "history" again. A new line will have been added, and you'll be able to verify (by clicking on "last") that you un-did the vandalism plus all subsequent bona fide edits, if any.  You are responsible for re-doing all the subsequent edits which you un-did.
 * Hint: In a vandalism case where sections of text were simply deleted and then subsequent edits were made by others, it may be easier for you to cut and paste those missing sections of text back in, than to revert and then re-do the edits.
 * Check the contribution history of the user who vandalized the article. (Click on their username. That will bring you directly to their User page. In the left navbar under "Toolbox", there is a "User contributions" link. Click that.)

AAAAAAAAAAARG <--- Example of an edit that should be reverted

Reverts do not cause edit conflicts
Reverts never cause an edit conflict - if between the moment you begin the revert process, and the moment you click Post (or Save page), someone else edits and saves the page, their edits will be silently overwritten by the reverted version (but still appear in the page history). So beware of reverting high-traffic pages! Conversely, if it looks like someone has deleted your edits, consider whether it may be one of these unfortunate revision conflicts.

Rollback
On the user contributions page, sysops have the additional "rollback" links at lines which are the last edit made by anybody to that article. Some user scripts (mentioned below) also give users the ability to rollback with an automated edit summary. The rollback link is also shown on the diff page when viewing the difference between any version of the page and the most recent one. Clicking on the link reverts to the previous edit not authored by the last editor, with an automatic edit summary of "Reverted edits by X (talk) to last version by Y," which marks the edit as "minor." If, between loading the User Contributions page and pressing "rollback," someone else edits or rolls back the page, or if there was no previous editor, you will get an error message.

The rollback link on the diff page is somewhat misleading, because reversion is not necessarily to the old version shown (the diff page may show the combined result of edits including some by other editors, or only part of the edits the rollback button would revert). To see the changes the rollback button would revert, view the corresponding diff page.

Rollbacks should be used with caution and restraint, in part because they leave no explanation for the revert in the edit summary. Reverting a good-faith edit may therefore send the message that "I think your edit was no better than vandalism and doesn't deserve even the courtesy of an explanation." It is a slap in the face to a good-faith editor. If you use the rollback feature for anything other than vandalism or for reverting yourself, it's polite to leave an explanation on the article talk page, or on the talk page of the user whose edit(s) you reverted.

Shortcut
The following tools have been developed to facilitate fighting vandalism on WikiMedia sites. They could be employed on SourceWatch but are not at this time.
 * Sam Hocevar's godmode-light.js script adds functionality similar to the admin rollback links described below. More info at w:Wikipedia:WikiProject User scripts.
 * The vandal edit can also be reverted using popups.

Reasons
Revert wars are usually considered harmful for the following reasons:
 * 1) They disrespect the work of the contributor. Being reverted can feel a bit like a slap in the face: "I worked hard on those edits, and someone just rolled it all back"
 * 2) They cause ill-will between users and negatively destabilize articles
 * 3) They make the page history less useful, waste space in the database
 * 4) They make it hard for other people to contribute, and flood recent changes and watchlists

Editors are discouraged to revert because there is disagreement, or the edit is bad or problematic. Users are encourage to explore alternate methods like raising the objections on a talk page, or following the processes in dispute resolution.

Explain reverts
When a revert is necessary, it is very important to let people know why you reverted. This helps the reverted person because they can remake their edit, but fixing whatever problem it is that you've identified.

Explaining reverts also helps other people. For example, it lets people know whether they need to even view the reverted version (in the case of, eg, "rv page blanking"). Because of the lack of non-verbal communication online, if you don't explain things clearly people will probably assume all kinds of nasty things, and that's one of the possible causes for edit wars. Explaining reverts also helps people who are using the encyclopedia article and checking the edit history to see to what extent they can rely on the information in the article.

If your reasons for reverting are too complex to explain in the edit summary, drop a note on the Talk page. A nice thing to do is to drop the note on the Talk page first, and then revert, rather than the other way round. Sometimes the other person will agree with you and revert for you before you have a chance. Conversely, if someone reverts your change without apparent explanation, you may wish to wait a few minutes to see if they explain their actions on the article's talk page or your user talk page.

SourceWatch-specific help
Because SourceWatch is a moderated wiki, there is an extra layer of protection against vandalism and malicious editors. If you are having a problem with these, please contact the SourceWatch editors by emailing friday_thorn(at)sourcewatch.org.