User:Pluma/adoption/twinkle

Twinkle is a user script designed and largely maintained by User:AzaToth, an administrator with a knack at coding scripts such as this. Twinkle allows a user-friendly interface that can automatically do a wide range of tasks, as well as providing non-administrators with admin-like tools. Chief among these, and the feature we're going to be using here, is "rollback", a reversion method that can undo multiple edits by a single editor at once. Rollback will undo all edits by the same editor, to the last revision made by a different editor. So, if Bob edits a page, then Vandal comes in and makes two edits, then you come in and rollback Vandal's edits, the article will be restored to Bob's version. This is different from the "undo" button, which can only do one edit at a time.

Until 2008, the official version of rollback was available only to administrators, due to its ability to undo a large number of edits with a single click of a button. As of January 9th, 2008, admins have been given the ability to grant other users the "rollbacker" permission mask, which allows non-admins the use of this feature. If and when you are given this permission, it provides an extra "[rollback]" link next to the undo button in page histories and diff pages. Long before then, however, Twinkle has allowed a similar version of rollback, with added compatibility for the other features offered by the script. Since you're new to the site, it is unlikely that an admin will be willing to grant you the permission yet - such tools are granted as a matter of earned trust and demonstrated knowledge of policy - so we're going to use Twinkle, which also lets you do other stuff anyway. It's really no big deal - I have been granted rollback permissions, but Twinkle is almost as efficient and lets you warn people as well as provide an edit summary. Other functions of Twinkle allow you to report vandals to administration for blocking, mark or propose pages for deletion, request protection of a page, and more.

Before we go on, I am not going to force you, by any means, to use Twinkle. I use it on a regular basis and enjoy the features it has, but that's just me. If you decide you'd rather not use it, you have no obligation at all to keep it. You can remove the script by following the installation steps in reverse.

Here's how to install Twinkle. Go ahead and do this now, so that you can follow the tasks further on: If the script installed correctly, you should see another tab button at the top of the page that says "TW". This is Twinkle
 * 1) Go to your preferences page.
 * 2) Go to the Gadgets tab
 * 3) Check the box in the browsing section that says, "Twinkle"
 * 4) Go to any other page

Note regarding users removing vandalism warning templates from their talk page
Please note that the current policy states that users are allowed without penalization to remove vandalism warnings from their user talk pages, doing so indicates that they have read the warning template.

Homework

 * 1) Go to your sandbox page and click on the page history. Now we're going to revert things the Twinkle way.
 * 2) Click on the TW tab.
 * 3) Click on the "last" link (second from the bottom). This should now correspond with the edit you made to the page a few minutes ago.
 * 4) In addition to all the usual stuff you see on a diff screen, now you've got more buttons! These buttons are the Twinkle version of rollback. On the left, you'll see a brown "Restore this version" link. This will undo all edits back to that edition of the page. This shouldn't be used too often, although may be necessary if multiple vandals hit a page all at once. The ones you'll be dealing with are on the right side. There are three forms of rollback within Twinkle. All three work essentially the same way, and identically to the actual rollback feature I mentioned before. The difference between the three is the edit summary left by the script. For what you know is vandalism, click the red button only. If you're pretty sure the editor made a genuine mistake, but it still needs to be removed, then click the "AGF" button (stands for Assume Good Faith). The blue button in the middle generally won't be used, but it goes neither direction (does not assume good or bad faith).
 * 5) Now, to revert your edit, click the red button (we'll be treating you as a vandal just for this demonstration). A page will load and begin spitting out a bunch of lines of text, telling you what the script is doing.
 * 6) Sometime during the script's running, it will open a new tab or window. This new screen will have your talk page open for editing. This is so that you can give the vandal (in this case, you) a warning.
 * 7) At the top of your talk page (in the new window), you'll see a small tab that says "warn", which should appear right next to "watch/unwatch". Click on this now (don't worry, you won't be giving yourself a warning!)
 * 8) A blue box should appear. This form allows you to select a warning message to issue to the vandal. After you vandal-revert someone, the form will have some information already filled in for you. Leave this alone. What you are interested in are the two menus up top. The first one allows you to select the level of warning to issue. For a first-time vandal edit, you should usually select a "General Note (1)" warning. If the vandal has been given warnings previously, you can go to the next highest level they haven't been given yet. (If the last warning was a level 2, the next should be level 3, and so forth). In the second box, choose the most appropriate reason for the reversion and warning. "Vandalism" is rather general and vague, but sometimes is the best to issue. DO NOT CLICK SUBMIT. When you are done looking around, close the menu by clicking the red X.
 * 9) Go to Special:NewPages
 * 10) Read the text at the top.
 * 11) Sine newcomers are often discouraged when their first article is immediately tagged, we'll go to the older new pages. To do this, scroll down to the bottom and click "older 100".
 * 12) Find an article that is highlighted in yellow and click on it. Yellow highlighting indicates that the page has not been looked at yet.
 * 13) If you see any issues with it (maybe it has bad grammar, isn't formal, needs to be broken up into sections, or something else), click on the TW tab.
 * 14) Click on the option that says "tag"
 * 15) scroll through the list of tags until you find ones that apply to the article.
 * 16) Check all boxes that apply
 * 17) Click on "Submit Query"
 * 18) Do this for three articles, then tell me which articles they were when you are done.
 * 19) For bonus points, do the maintenance for which you tagged the article for.
 * 1) For bonus points, do the maintenance for which you tagged the article for.

When using Twinkle, be very careful about what you are doing and why. Twinkle is a very powerful tool, and because of this, it creates a great potential to cause great damage. Misuse of this tool, intentional or otherwise, can and will result in a block. You should not use the functions of this script until you understand how to do so. These will be explained to you in time. Even for those functions you do know how to use, if you are ever in doubt about what action to take in a situation, just don't take it. On patrol, there is always a more experienced editor just seconds behind you, so it'll be taken care of. As you do patrol, you'll become more and more confident about what it and what is not vandalism, and our next lesson on vandalism deals with those other kinds. Until then, good luck going on patrol! Please let me know as soon as possible if you have any questions. Happy editing as always.