Wikipedia:Principle of Some Astonishment: Difference between revisions
Line 13: | Line 13: | ||
::{{tq|<s>At the end of play, points are tallied up and the pieces can be thrown again or stored in a container for another use.</s>}} |
::{{tq|<s>At the end of play, points are tallied up and the pieces can be thrown again or stored in a container for another use.</s>}} |
||
:Comment: ''Of course'' the points are tallied up at the end of the game. ''Of course'' players can either play again or put the game away "in a container". (If the rules said to ignore the score sheet at the end, then called for players to burn the game pieces or use them to commit ritual suicide, THAT would be worth mentioning in the article.) |
:Comment: ''Of course'' the points are tallied up at the end of the game. ''Of course'' players can either play again or put the game away "in a container". (If the rules said to ignore the score sheet at the end, then called for players to burn the game pieces or use them to commit ritual suicide, THAT would be worth mentioning in the article.) |
||
;In the article '[http://en.wiki.x.io/?oldid=769979721 Mary_Lee Ware]:'' |
|||
{{tq|The rug <s>on the floor of<s> <u>in</u> the Edward Hall Library in the First Parish in Cambridge was "given in memory of Miss Mary Lee Ware, a first cousin of Rev. Edward Hall" who presided as Minister from 1882 to 1893.}} |
|||
:Comment: Though exceptions are known, readers not raised in caves will know that rugs are typically deployed on floors. |
|||
Revision as of 19:11, 12 March 2017
This is an essay on selection of article content. It contains the advice or opinions of one or more Wikipedia contributors. This page is not an encyclopedia article, nor is it one of Wikipedia's policies or guidelines, as it has not been thoroughly vetted by the community. Some essays represent widespread norms; others only represent minority viewpoints. |
This page in a nutshell: The Principle of least astonishment notwithstanding, consider omitting obvious details from articles. |
Principle of Some Astonishment
Concision makes for good writing. Sometimes editors clutter their prose with pedestrian details that the reader likely knows already or would naturally assume. Far from making the page more informative, this wastes the reader's time and brainpower. If it doesn't convey useful information, omit it!
Here are some examples of articles belaboring the painfully obvious:
- In the article Pick-up sticks:
-
At the end of play, points are tallied up and the pieces can be thrown again or stored in a container for another use.
- Comment: Of course the points are tallied up at the end of the game. Of course players can either play again or put the game away "in a container". (If the rules said to ignore the score sheet at the end, then called for players to burn the game pieces or use them to commit ritual suicide, THAT would be worth mentioning in the article.)
- In the article 'Mary_Lee Ware
The rug
on the floor of in the Edward Hall Library in the First Parish in Cambridge was "given in memory of Miss Mary Lee Ware, a first cousin of Rev. Edward Hall" who presided as Minister from 1882 to 1893.
- Comment: Though exceptions are known, readers not raised in caves will know that rugs are typically deployed on floors.
- In the article US Airways Flight 1549:
- Comment: Of course it was recorded. That's how we know about it.
- Comment: The word quickly is superfluous, because our readers' innate cunning will inform them that controllers generally act with dispatch in such situations. (Had they instead been lackadaisical, THAT would be worth mentioning in the article.)
- Comment: The part from "signalling his intention ..." on is probably unnecessary, because our readers aren't mentally defective. They will conclude without being told that when Sullenberger said "We can't do it ... We're gonna be in the Hudson", he's hinting that (a) he's going to land on the Hudson and (b) he's taking this unconventional step because more orthodox landing sites are out of reach. (Had he instead done it because he wanted a bath, THAT would be worth mentioning in the article.)
- Comment: The immediately bit seems unnecessary. (Had the captain made a cup of tea before ordering "Evacuate!", THAT would be worth mentioning in the article.)
- Comment: If the fire chief, seeing people crowded onto the wings of a sinking airliner, had radioed, "False alarm – no big deal", THAT would be worth mentioning in the article.
- In the article University_of_Texas_Tower_Shooting:
-
He then drove to a hardware store, where he purchased a Universal M1 carbine, two additional ammunition magazines and eight boxes of ammunition, telling the cashier he planned to hunt wild hogs. At a gun shop he purchased four further carbine magazines, six additional boxes of ammunition, and a can of gun cleaning solvent. He then drove to Sears, where he purchased a Sears Model 60 12 gauge semi-automatic shotgun before returning home
with his purchases.
- Comment: If he'd bought all that stuff and then left it at the store, THAT would be worth mentioning in the article.
- In the article Charles Whitman:
-
Whitman was reportedly the youngest person
in the worldever to become an Eagle Scout at that time.
- Comment: Are people becoming Eagle Scouts elsewhere than "in the world"? Perhaps on Mars?
- In the article Donald Trump:
Comment: The reader will know without being told that this is a "view".
Comment: We're safe in assuming that the reader will intuit that this "view" shows a "crowd".
- In the article Harry Elkins Widener:
|
Comment: Did I mention that it's Harry Elkins Widener? (Contrary to popular opinion, not every image needs a caption, and that's certainly true when the image is in an infobox adorned with a title that already provides an adequate description. Alternatively, the caption might be changed to Widener in 1910, or even more simply, In 1910.) |
Principle of Complete Puzzlement
- In the article Chuck Shumer:
In March 2009, Schumer announced his support for same-sex marriage, noting that it "was time". Schumer previously supported civil unions. At a private
risottodinner with gay leaders ...
- Comment: This actually illustrates the opposite of the Principle of Some Astonishment – the Principle of Complete Puzzlement. Some details don't belong because, though neither obvious nor even predictable, they have no hope of adding to the reader's understanding of the subject because they're irrelevant. What in the world does risotto have to do with anything? Is this the gay version of the classic pancake breakfast? Why aren't you telling us what wine was served?