Revision as of 15:35, 26 April 2009 editPokémaniac Thomas (talk | contribs)91 edits →See also: typo← Previous edit | Latest revision as of 21:35, 13 December 2024 edit undoPenultimate supper (talk | contribs)Extended confirmed users1,249 edits →Some quick tips: CETags: Mobile edit Mobile web edit Advanced mobile edit | ||
(665 intermediate revisions by more than 100 users not shown) | |||
Line 1: | Line 1: | ||
{{Redirect|WP:BECONCISE|the policy on article title length|WP:CONCISE}} | |||
⚫ | {{ |
||
{{Redirect|WP:SUCCINCT|the style guideline that recommends succinctness in articles|Misplaced Pages:Manual of Style}} | |||
{{policy in a nutshell|Write concisely.}} | |||
{{Essay|WP:TLDR|cat=Misplaced Pages essays about editing}} | |||
{{Nutshell|Be concise.}} | |||
{{Cquote|quote=The present letter is a very long one, simply because I had no leisure to make it shorter.|author=]<ref name=PascalEnglish01a>{{cite book|url= https://ebooks.adelaide.edu.au/p/pascal/blaise/p27pr/complete.html |title=The Provincial Letters|author= Blaise Pascal |author-link=Blaise Pascal |orig-year=original date 1656-1657|translator-first=Thomas|translator-last=M'Crie|translator-link=Thomas M'Crie the elder|publisher=]|date=December 2014|access-date=7 November 2017 |quote=(Letter 16){{nbsp}}... The present letter is a very long one, simply because I had no leisure to make it shorter.}}</ref><ref name=PascalFrench01a>{{cite book|url= https://www.ebooksgratuits.com/ebooksfrance/pascal_les_provinciales.pdf |title=Les provinciales : ou les Lettres écrites par Louis de Montalte à un provincial de ses amis et aux RR. PP. Jésuites |author= Blaise Pascal |author-link= Blaise Pascal |orig-year=original date 1656-1657|language=French|publisher=eBooksFrance|page=116|date=January 2001|access-date=7 November 2017 |quote= (Letter 16){{nbsp}}... Je n'ai fait celle−ci plus longue que parce que je n'ai pas eu le loisir de la faire plus courte.}} The document is an adaptation of an electronic text from the National Library of France (])</ref>}} | |||
'''"Too long; didn't read"''' (sometimes abbreviated to "tl;dr") is a snarky reply to someone who described something in an unnecessarily verbose way.<ref>{{cite dictionary |url=http://www.urbandictionary.com/define.php?term=Too+long+didn't+read |encyclopedia=Urban Dictionary |title=Too long didn't read |accessdate=2008-05-13}}</ref> | |||
'''Too long; didn't read''' (abbreviated '''TL;DR''' and '''tl;dr''') is a shorthand to indicate that a passage is too long to invest the time to digest it.<ref name="Chatfield2016">{{cite book|author=Tom Chatfield|title=Netymology: From Apps to Zombies: A Linguistic Celebration of the Digital World|url=https://books.google.com/books?id=CHw1CwAAQBAJ&pg=PT124|year=2016|publisher=Quercus|isbn=978-1-62365-165-7|page=124}}</ref> Akin to ]. | |||
Misplaced Pages editors like to write, or they would not be here. Often, what they write is longer than it need be. Administrator candidates are often judged by how much they have written here. This may be why many of the instructions on Misplaced Pages, from policies and guidelines to ], could be shorter and simpler, but convey the same message. | |||
The label is often used to point out excessive verbosity or to signify the presence of and location of a short summary in case the page is too long and won't otherwise be read.<ref>{{cite web |url=http://www.urbandictionary.com/define.php?term=tl%3Bdr |title=Urban Dictionary, definition #7 |author=Soonmme |website= UrbanDictionary.com |date=2008-07-14 |access-date=2014-08-18}}</ref> It can be misused as a tactic to thwart collaborative editing or a ]. If a discussion is reasonably concise, it is best practice to ]. | |||
It is difficult to learn all these rules before beginning to contribute and new editors can become discouraged when this prevents them from contributing successfully. Some of our core policies, such as the ], are very verbose, technical, hard to read, and hard to understand. Editors will often ignore instructions that will take them too much time to understand. | |||
== Reasons for length == | |||
In the classic words of ], | |||
Many people edit Misplaced Pages because they enjoy writing; however, that passion can result in overlong ]. This reflects a lack of time or commitment to refine an effort through successively more concise ]. With some application, natural redundancies and digressions can often be eliminated. Recall the venerable paraphrase of ]: "I made this so long because I did not have time to make it shorter."<ref name=PascalEnglish01a/><ref name=PascalFrench01a/> | |||
Also writers can incorrectly believe that long sentences and big words make that writer appear learned.<ref>{{cite web|url=http://www.livescience.com/448-study-simple-writing-smart.html |title=Study: Simple Writing Makes You Look Smart |publisher=Livescience.com |date=2005-10-31 |access-date=2012-04-13}}</ref> Some inexperienced contributors over-avoid ] by using more words (see ]/]). Even capable authors recognize the risk of distortion through brevity.<ref>http://www.npr.org/blogs/13.7/2014/02/03/270680304/this-could-have-been-shorter "...{{nbsp}}writers may err towards wordiness out of concern that short prose which is not carefully edited (at high time cost) would oversimplify, to the point of distorting or omitting, or carry a higher risk of being misunderstood"</ref> | |||
:''Vigorous writing is concise. A sentence should contain no unnecessary words, a paragraph no unnecessary sentences, for the same reason that a drawing should have no unnecessary lines and a machine no unnecessary parts. This requires not that the writer make all his sentences short, or that he avoid all detail and treat his subjects only in outline, but that every word tell.''<ref>{{cite book|last=Strunk|first=William|title=The Elements of Style|publisher=Bartleby.com|date=1918|chapter=Elementary Principles of Composition|chapterurl=http://www.bartleby.com/141/strunk5.html|accessdate=2008-05-13}}</ref> | |||
Some policies and procedures can encourage overlong prose due to imposing arbitrary limits. The ] process requires established articles to have a fivefold expansion of prose within a seven-day window to be considered for listing on the main page. This can encourage over-verbose writing to ]. | |||
Please try to write in as few words as you can, without using technical jargon. When you must write lengthy instructions, please include a summary of them at the beginning. Try to keep your vocabulary simple so that non-native English readers can understand. | |||
A trusted ] states that "brevity is the soul of wit."<ref> {{Cite book| last = Shakespeare| first = William| title = ] | publisher = Washington Square Press| date = 1992| location = New York| page = 89}} Act 2, Scene 2, line 90: "Therefore, since brevity is the soul of wit{{nbsp}}..."</ref> Similarly, "omit needless words."<ref>{{cite book|last=Strunk|first=William|title=The Elements of Style|publisher=Bartleby.com|date=1918|chapter=Elementary Principles of Composition|chapter-url=http://www.bartleby.com/141/strunk5.html|access-date=2008-05-13}}</ref> Editors are encouraged to write concisely and to use plain vocabulary when possible. Remember that English may not be a reader's native tongue. If length is essential, a short summary is advised. | |||
While bloated composition may reflect the emotions of an editor, it should be noted that some people are constitutionally ]. It is impossible for you, as an editor, to affect either of these before the fact. When editing, always respect Misplaced Pages policies and editors' feelings. Take the time to distill your thoughts for better communication and rapport. | |||
Internal policy discussions on talk pages can often become long-winded, too, usually for two reasons: because of the detailed nature of ] (and their often complicated interaction with each other), and because curt and questionable assertions of policy rationales (especially when many are made in series in a single post) may require a fairly detailed response. The cure for this problem is to make a clear, policy-related statement to begin with, and avoid citing more policy and guideline pages than are necessary to get the point across (many say the same thing in slightly different wording). If you cite five such pages in vague terms for the same point, you open the door to ] about wording and interpretation{{snd}}you may get five paragraphs of rebuttal in response instead of one sentence of agreement. | |||
== Reducing wordiness == | |||
{{see also|Misplaced Pages:Summary style|Misplaced Pages:Content forking#Article spinoffs}} | |||
{{cquote|Perfection is achieved not when there is nothing more to add, but when there is nothing left to take away|author=], French writer and aviator}} | |||
Per the ], text in Misplaced Pages should be written succinctly; or, existing texts should be trimmed if it contains ]. The article should be ] into another article when appropriate. Be clear before excising copy that it can't be refined and kept. Tagging bloated plot summaries at movie, book, and play pages with the {{t|plot}} template is not as good as winnowing them yourself. | |||
Some linguists (such as ] in posts at ]) criticize ]'s advice "omit needless words" in the fear that unskilled editors may mistake even necessary length for dross and delete it. Strunk and White, however, were unambiguous that ] does not require "the writer make all his sentences short, or that he avoid all detail and treat his subjects only in outline, but that every word tell." Deleting is not always equivalent to improving, and intelligently differentiating the cases deserves care. | |||
== Maintain civility == | |||
Being too quick to ] may come across as dismissive and rude. Preferably, create a section on their ] and politely offer advice there. | |||
Avoid ]s. Substituting a flippant "tl;dr" for reasoned response and cordiality ] and amounts to ]. Just as one cannot ], neither can one prove by wielding a four letter initialism. When illumination, patience, and wisdom are called for, answer with them. | |||
==Some quick tips== | |||
* '''Provide summary/ synopsis''' | |||
A further option for both readers and writers is to structure the writing so it can be ] effectively. This means writing the ] as a summary of the paragraph, so the reader can quickly know which paragraphs or sections are of interest to read for more detail, in addition to the usual practice of putting a summary at the beginning of articles or sections.<ref>{{cite web |url= http://wts.indiana.edu/pamphlets/paragraphs.shtml|title= Paragraphs and Topic Sentences|access-date=2017-08-11}}</ref> This works even when the content is concise, or for some uses should be complete, but a reader wishes to skim for speed in a disciplined and more accurate way. | |||
*<B> If any talk page discussion is too long</B>: | |||
** First best try to trim your response yourself. Maybe you can try writing first in your own sandbox before posting on the talk page. Remember don't edit other user's responses. | |||
** <u> <nowiki><u></nowiki> Underline important sentences <nowiki></u></nowiki> </u> in your response can help readers in quick browsing. Rather than repeating same arguments again and again you can use <u>(emphasis added)</u> or <u>(pl. read again)</u>, if needed, in brackets. | |||
** Use collapse template | |||
{{collapse top| for your detailed long paragraphs}} | |||
** Use <nowiki>{{collapse top|Reply with details 1}} {{collapse bottom}}</nowiki> | |||
{{collapse bottom}} | |||
** <u>Provide mid discussion synopsis and discussion end synopsis.</u> Always remember Misplaced Pages is collaborative project and synopsis helps other users to understand main points of ongoing discussion. | |||
** If you want to jot down a thorough response for the sake of maintaining a record, you can write in one of your own userspace sub-pages and include a link in the relevant discussion. | |||
*'''In Nutshell''': <u> Be concise.</U> | |||
== See also == | == See also == | ||
{{Misplaced Pages glossary}} | |||
⚫ | * {{tl|Very long}} |
||
* ] | * ] | ||
* ]: Misplaced Pages's rules and guidelines should not become excessively complicated | |||
⚫ | * ] | ||
* ] | |||
* ] | |||
* ] | * ] | ||
* ] | |||
* ] | |||
⚫ | * ] | ||
* ] | |||
* ], which advocates familiarizing yourself with a discussion before participating in it | |||
* ] | |||
* ] | |||
* ] | |||
* ] | |||
* {{tl|TLDR}} {{ndash}} adds <small>(])</small>; for use in discussions | |||
⚫ | * {{tl|Very long}} {{ndash}} Template used to flag articles or sections that need trimming. | ||
* ] | |||
* ] | |||
* ]<!--Both versions at this DAB page are relevant.--> | |||
* ] | |||
== |
== References == | ||
{{reflist}} | {{reflist}} | ||
== External links == | |||
⚫ | {{wiktionary|TLDR}} | ||
* Tim Dowling, ''],''14 January 2008. Retrieved 14 April 2024. | |||
{{Misplaced Pages essays}} | |||
] |
Latest revision as of 21:35, 13 December 2024
"WP:BECONCISE" redirects here. For the policy on article title length, see WP:CONCISE. "WP:SUCCINCT" redirects here. For the style guideline that recommends succinctness in articles, see Misplaced Pages:Manual of Style. Essay on editing Misplaced PagesThis is an essay. It contains the advice or opinions of one or more Misplaced Pages contributors. This page is not an encyclopedia article, nor is it one of Misplaced Pages's policies or guidelines, as it has not been thoroughly vetted by the community. Some essays represent widespread norms; others only represent minority viewpoints. | Shortcut |
This page in a nutshell: Be concise. |
“ | The present letter is a very long one, simply because I had no leisure to make it shorter. | ” |
— Blaise Pascal |
Too long; didn't read (abbreviated TL;DR and tl;dr) is a shorthand to indicate that a passage is too long to invest the time to digest it. Akin to Wall of text.
The label is often used to point out excessive verbosity or to signify the presence of and location of a short summary in case the page is too long and won't otherwise be read. It can be misused as a tactic to thwart collaborative editing or a stoop to ridicule. If a discussion is reasonably concise, it is best practice to read it before commenting.
Reasons for length
Many people edit Misplaced Pages because they enjoy writing; however, that passion can result in overlong composition. This reflects a lack of time or commitment to refine an effort through successively more concise drafts. With some application, natural redundancies and digressions can often be eliminated. Recall the venerable paraphrase of Pascal: "I made this so long because I did not have time to make it shorter."
Also writers can incorrectly believe that long sentences and big words make that writer appear learned. Some inexperienced contributors over-avoid leaving any ambiguity by using more words (see WP:NOTSTATUTE/GUIDE). Even capable authors recognize the risk of distortion through brevity.
Some policies and procedures can encourage overlong prose due to imposing arbitrary limits. The Did you know? process requires established articles to have a fivefold expansion of prose within a seven-day window to be considered for listing on the main page. This can encourage over-verbose writing to game the system.
A trusted aphorism states that "brevity is the soul of wit." Similarly, "omit needless words." Editors are encouraged to write concisely and to use plain vocabulary when possible. Remember that English may not be a reader's native tongue. If length is essential, a short summary is advised.
While bloated composition may reflect the emotions of an editor, it should be noted that some people are constitutionally loquacious. It is impossible for you, as an editor, to affect either of these before the fact. When editing, always respect Misplaced Pages policies and editors' feelings. Take the time to distill your thoughts for better communication and rapport.
Internal policy discussions on talk pages can often become long-winded, too, usually for two reasons: because of the detailed nature of Misplaced Pages policies and guidelines (and their often complicated interaction with each other), and because curt and questionable assertions of policy rationales (especially when many are made in series in a single post) may require a fairly detailed response. The cure for this problem is to make a clear, policy-related statement to begin with, and avoid citing more policy and guideline pages than are necessary to get the point across (many say the same thing in slightly different wording). If you cite five such pages in vague terms for the same point, you open the door to wikilawyering about wording and interpretation – you may get five paragraphs of rebuttal in response instead of one sentence of agreement.
Reducing wordiness
See also: Misplaced Pages:Summary style and Misplaced Pages:Content forking § Article spinoffs“ | Perfection is achieved not when there is nothing more to add, but when there is nothing left to take away | ” |
— Antoine de Saint-Exupéry, French writer and aviator |
Per the Manual of Style, text in Misplaced Pages should be written succinctly; or, existing texts should be trimmed if it contains redundancy. The article should be split into another article when appropriate. Be clear before excising copy that it can't be refined and kept. Tagging bloated plot summaries at movie, book, and play pages with the {{plot}} template is not as good as winnowing them yourself.
Some linguists (such as Geoffrey K. Pullum in posts at Language Log) criticize Strunk & White's advice "omit needless words" in the fear that unskilled editors may mistake even necessary length for dross and delete it. Strunk and White, however, were unambiguous that concision does not require "the writer make all his sentences short, or that he avoid all detail and treat his subjects only in outline, but that every word tell." Deleting is not always equivalent to improving, and intelligently differentiating the cases deserves care.
Maintain civility
Being too quick to pointedly mention this essay may come across as dismissive and rude. Preferably, create a section on their talk page and politely offer advice there.
Avoid ad hominems. Substituting a flippant "tl;dr" for reasoned response and cordiality stoops to ridicule and amounts to thought-terminating cliché. Just as one cannot prove through verbosity, neither can one prove by wielding a four letter initialism. When illumination, patience, and wisdom are called for, answer with them.
Some quick tips
- Provide summary/ synopsis
A further option for both readers and writers is to structure the writing so it can be skimmed effectively. This means writing the first sentence of each paragraph as a summary of the paragraph, so the reader can quickly know which paragraphs or sections are of interest to read for more detail, in addition to the usual practice of putting a summary at the beginning of articles or sections. This works even when the content is concise, or for some uses should be complete, but a reader wishes to skim for speed in a disciplined and more accurate way.
- If any talk page discussion is too long:
- First best try to trim your response yourself. Maybe you can try writing first in your own sandbox before posting on the talk page. Remember don't edit other user's responses.
- <u> Underline important sentences </u> in your response can help readers in quick browsing. Rather than repeating same arguments again and again you can use (emphasis added) or (pl. read again), if needed, in brackets.
- Use collapse template
for your detailed long paragraphs |
---|
|
- Provide mid discussion synopsis and discussion end synopsis. Always remember Misplaced Pages is collaborative project and synopsis helps other users to understand main points of ongoing discussion.
- If you want to jot down a thorough response for the sake of maintaining a record, you can write in one of your own userspace sub-pages and include a link in the relevant discussion.
- In Nutshell: Be concise.
See also
This page is referenced in the Misplaced Pages Glossary.- Misplaced Pages:Article size
- Misplaced Pages:Avoid instruction creep: Misplaced Pages's rules and guidelines should not become excessively complicated
- Misplaced Pages:Don't bludgeon the process
- Misplaced Pages:Germane
- Misplaced Pages:Hold the pepper
- Misplaced Pages:Keep it concise
- Misplaced Pages:Manual of Style
- Misplaced Pages:It should be noted
- Misplaced Pages:Read before commenting, which advocates familiarizing yourself with a discussion before participating in it
- Misplaced Pages:Too much detail
- Misplaced Pages:Wall of text
- User:Tony1/Redundancy exercises: removing fluff from your writing
- Template:Policy in a nutshell
- {{TLDR}} – adds (tl;dr); for use in discussions
- {{Very long}} – Template used to flag articles or sections that need trimming.
- Hypergraphia
- Succinctness
- Logorrhea
- Self-reference
References
- ^ Blaise Pascal (December 2014) . The Provincial Letters. Translated by M'Crie, Thomas. University of Adelaide. Retrieved 7 November 2017.
(Letter 16) ... The present letter is a very long one, simply because I had no leisure to make it shorter.
- ^ Blaise Pascal (January 2001) . Les provinciales : ou les Lettres écrites par Louis de Montalte à un provincial de ses amis et aux RR. PP. Jésuites (PDF) (in French). eBooksFrance. p. 116. Retrieved 7 November 2017.
(Letter 16) ... Je n'ai fait celle−ci plus longue que parce que je n'ai pas eu le loisir de la faire plus courte.
The document is an adaptation of an electronic text from the National Library of France (Bibliothèque Nationale de France) - Tom Chatfield (2016). Netymology: From Apps to Zombies: A Linguistic Celebration of the Digital World. Quercus. p. 124. ISBN 978-1-62365-165-7.
- Soonmme (2008-07-14). "Urban Dictionary, definition #7". UrbanDictionary.com. Retrieved 2014-08-18.
- "Study: Simple Writing Makes You Look Smart". Livescience.com. 2005-10-31. Retrieved 2012-04-13.
- http://www.npr.org/blogs/13.7/2014/02/03/270680304/this-could-have-been-shorter "... writers may err towards wordiness out of concern that short prose which is not carefully edited (at high time cost) would oversimplify, to the point of distorting or omitting, or carry a higher risk of being misunderstood"
- Shakespeare, William (1992). Hamlet. New York: Washington Square Press. p. 89. Act 2, Scene 2, line 90: "Therefore, since brevity is the soul of wit ..."
- Strunk, William (1918). "Elementary Principles of Composition". The Elements of Style. Bartleby.com. Retrieved 2008-05-13.
- "Paragraphs and Topic Sentences". Retrieved 2017-08-11.
External links
- Tim Dowling, "Misplaced Pages too long-winded for you? Try the simple version," The Guardian,14 January 2008. Retrieved 14 April 2024.