|This page in a nutshell: When ing, be sure to summarize your contributions.|
An summary is a brief explanation of an to a Wikipedia page. Summaries help other ors by (a) saving the time to open up the to find out what it's all about, (b) providing a reason for the , and (c) providing information about the on diff pages and lists of changes (such as page histories and watchlists).
The Wikipedia community strongly encourages ors to provide meaningful summaries. To add a summary, type in the text entry field in the Edit summary box located near the bottom of the Editing page. The box looks like this:
It is considered good practice to provide a summary for every , especially when reverting (undoing) the actions of other ors or deleting existing text; otherwise, people may question your motives for the . In appropriate circumstances, a meaningful summary can be quite brief ("ce" and "rvv" for example). The important thing is to provide meaningful information.
Accurate summaries help other contributors decide whether they want to review an , and to understand the change should they choose to review it. Edits that do not have an summary are more likely to be reverted incorrectly, because it may not be obvious what the purpose of the was. Editors should not revert an otherwise good because of a missing or confusing summary; good ors may simply have forgotten, or a confusing summary may have been the result of an autofill mishap. (If the summary itself violates privacy or other policies, see the Fixing section below.) However, realistically, when a major (e.g., addition or deletion of a substantial amount of article text, or a substantial rewrite) doesn't have an summary, some busy ors might not assume good faith and revert the change without evaluating it properly. Providing an summary helps prevent that kind of error.
Summaries are less important for minor changes (which means generally unchallengeable changes, such as spelling or grammar corrections), but a brief note like "fixed spelling" is helpful even then.
To avoid accidentally leaving summaries blank, registered ors can select "Prompt me when entering a blank summary" on the Editing tab of the user preferences.
Proper use of summaries is critical to resolving content disputes. Edit summaries should accurately and succinctly summarize the nature of the , especially if it could be controversial. If the involves reverting previous changes, it should be marked as a revert ("rv") in the summary.
Avoid using summaries to carry on debates or negotiation over the content. This creates an atmosphere where the only way to carry on discussion is to revert other ors! If you notice this happening, start a section on the talk page and place your comments there. This keeps discussions and debates away from the article page itself. For example:
As with any other Wikipedia space, do not express opinions of other users in summaries.
After you publish the page, you cannot change the summary, so be careful with it, particularly if you are in a heated content dispute – do not write things you will regret.
If you make an important omission or error in an summary, you can correct this by making a dummy (a change in the page with no visible effects), and adding further information in the dummy 's summary.
In the extreme case of an summary containing certain kinds of harmful content, the summary can be deleted on request. They may be removed from public view by administrators using revision deletion; such summaries remain visible to administrators. In even more limited circumstances, the entire may be oversighted, leaving it and its summary visible only to the handful of users with the Oversight permission.
<nowiki>...</nowiki>tags. Therefore, copying wikitext in the summary box may be preferable to copying text from the preview, except when one wants to save space. Other wikitext coding is not interpreted. Although URLs do not produce clickable links, a wikilink with Special:Diff/ can make clickable diffs, and Special:PermaLink/ can make permanent links.
~~~~has no effect, so do not sign summaries.
The summary appears in black italics in the following places:
When adding a new section to a discussion page with the "new section" button, the section title is used as the summary. When ing an existing section, the section title is inserted at the beginning of the summary, enclosed with /* and */ marks, for example /* External links */. Details of the should be added after this text.
When viewing such an summary, the section name will appear in blue, with a small arrow next to it: →External links. Click the arrow or section name to view the section (if the section no longer exists, the link will simply take you to the top of the page).
If you create a new section before or after an existing section by clicking a section "" link, delete the text between /* and */ marks (or change it to the new section title) to avoid confusion.
Note: Tools that track summary usage by a user (such as XTools) do not consider the auto-added part as a summary; that's any part within /* and */. You're encouraged to provide real summary, whether the box contains such auto-summary or not.
In certain circumstances, an automatic summary is generated when an is published without one. This is slightly different from the summary added when ing a section, as that can be modified by the user before saving.
Except for the automatic summary when creating a redirect, which usually says all that needs to be said, these are not a substitute for a proper summary – you should always leave a meaningful summary, even in the above cases. They are, however, useful in providing some context for s made by inexperienced users who are not aware of the importance of summaries, and for spotting vandalism.
When starting a new thread on a talk page by using the "New section" tab, the text you type into the "subject/headline" field becomes both the heading of your discussion topic, and the summary for that .
Tags (i.e., tags) are brief messages that the software automatically places next to certain s in histories, recent changes and other special pages. They are implemented by the filter to help assist vandalism patrollers and other page watchers. They cannot be added or removed manually.
If you are a registered user and want to show your commitment to always leaving summaries, which will remind other users of the importance of doing so, you can use any of the following userboxes:
The limit of 500 characters is an approximation. The actual limit is 500 Unicode codepoints. Most characters occupy one codepoint, but some characters like those with diacritics or emojis may consist of more than one codepoint. The limit of 500 codepoints includes the section title marker (and the associated
/* */) and also any wiki markup that may be present.
When the is done by a bot, through an external tool (such as WP:AWB) or through some user script or gadget, it's the responsibility of the tool or script to safeguard against overflowing this limit. In any situation where more than 500 codepoints are entered for the summary, the summary is truncated to 500 codepoints when the page is published.
|This page is referenced in the Wikipedia Glossary.|