Wikipedia:Please clarify
From Wikipedia, the free encyclopedia
This is an information page.
It is not one of Wikipedia's policies or guidelines, but rather intends to describe some aspect(s) of the Wikipedia:Writing better articles guideline. It may reflect varying levels of consensus and vetting.
Shortcuts
WP:CLARIFY
WP:CONFUSE
The aim of this page is to describe ways to clarify text or request such clarification. There are inline cleanup tags to flag specific wording that is likely to be confusing to the average reader.
Contents
1When you need to flag unclear text
2How to mark articles for clarification
3How to improve articles that need clarification
4Specific clarification
5See also
5.1Related inline templates
5.2Message-box templates
5.3Related pages
6References
When you need to flag unclear text
It is always best to take care of something when you notice it, but that is not always possible. You can choose one of these templates that tag text with inline messages to request specific clarifications that you cannot provide yourself:
When using these templates, be specific: mark individual phrases, sentences, and sections in preference to entire articles. Also be sure to leave specific suggestions for improvement on the article's talk-page​.
The templates' pages will almost always have additional documentation on usage and parameters​. If not, you can leave a message on the template's talk page requesting such information be added.
How to mark articles for clarification
To ask for clarification for a particular phrase or sentence, simply type {{clarify}} or {{what}} (after the phrase or sentence) to display a superscripted tag (the tag will link here):
This is a confusing sentence, which needs readers to apply much energy and time in order to understand the implicit meanings behind it, and needs to be clarified/rewritten.​[​clarification needed]
To ask for further explanation of a point made in a particular phrase or sentence, simply type {{​explain​}} or {{​elucidate​}} (after the phrase or sentence) to display a superscripted tag (the tag will link here):
This sentence contains unexplained jargon.​[​further explanation needed]
To ask for clarification for a particular section, simply type
{{​Confusing​|section}}
at the top of the section, to generate the following tag-box:
This section may be confusing or unclear to readers. Please help clarify the section. There might be a discussion about this on the talk page. (July 2019) (Learn how and when to remove this template message)
then update the article's talk page with specific aspects to be improved.
To ask for clarification for an entire article, consider first whether it would be more productive to tag individual phrases, sentences, or sections with {{​clarify​}}. If you cannot identify specific parts of the article that need clarification, write what aspects of the article you believe need clarification on the article's talk page before tagging the entire article with {{​confusing​}}.
How to improve articles that need clarification
Compare two sentences: "Notwithstanding the controversy, she, with practiced skill, proceeded to navigate MegaX Corporation through difficult financial straits" versus "Despite the controversy, she navigated MegaX through difficult financial straits" (two prepositions, and note the removal of non-neutral assessment).
Specific clarification
There are some common situations where use of a more specific clarification template might make the desired clarification clearer. A common case is an article citing a scientific measurement without indicating how the measurement was taken. For example, the following statement about solar intensity at the earth's surface without specifying the sun's elevation could be annotated with the following tag:
The following tag links to a Wikipedia project to clear bias based on the source of the information:
"The sun's intensity is 90 watts per square meter."​[​where?​]
See also
{{​Distinguish​}}
Related inline templates
Message-box templates
Related pages
References
^ Fenimore Cooper's Literary Offences by Mark Twain
Inline cleanup tags
Attribution
Clarity
Miscellaneous
Neutrality
Precision
{{By how much​}}​{{​Definition​}}​{{​Definition needed}}{{Example needed}}{{Example needed span​}}​{{​Explain​}}​{{​How​}}​{{​How often​}}​{{​Misquoted​}}​{{​Quantify​}}​{{​Specify​}}​{{​Vague​}}​{{​When​}}​{{​Where​}}​{{​Which​}}​{{​Who else}}{{Why}}{{Year needed}}
Time-sensitivity
Verifiability
Dubious
Incomplete
or broken
citation
Missing or
problematic
reference
{{Additional citation needed}}{{Better source needed}}{{Better source needed example}}{{Check quotation}}{{Chronology citation needed}}{{Citation needed}}{{Citation needed span}}{{Citation not found}}{{COI source}}{{Deprecated inline}}{{Excessive citations inline}}{{Failed verification}}{{Failed verification span​}}​{{​Imagefact​}}​{{​Irrelevant citation}}{{Medical citation needed}}{{Medical citation needed span}}{{Nonspecific}}{{Not verified in body}}{{Obsolete source}}{{Page range too broad}}{{Primary source inline}}{{Promotional source}}{{Quote without source}}{{Request quotation}}{{Request quotation span​}}​{{​Retracted​}}​{{​Scientific citation needed}}{{Self-published inline}}{{Tertiary source inline}}{{Third-party inline}}{{Unreliable fringe source}}{{Unreliable medical source}}{{Unreliable source?}}{{Verify quote}}{{Verify source}}
Wording
General advice
Categories: Wikipedia information pagesWikipedia how-to
Search
This page was last edited on 18 March 2021, at 07:50 (UTC).
Text is available under the Creative Commons Attribution-ShareAlike License; additional terms may apply. By using this site, you agree to the Terms of Use and Privacy Policy. Wikipedia® is a registered trademark of the Wikimedia Foundation, Inc., a non-profit organization.
Privacy policy
About Wikipedia
Disclaimers
Contact Wikipedia
Mobile view
Developers
Statistics
Cookie statement
TalkContributionsCreate accountLog in
Project pageTalk
ReadView sourceView history
Visit the main pageMain pageContentsCurrent eventsRandom articleAbout WikipediaContact usDonateHelpLearn to editCommunity portalRecent changesUpload fileWhat links hereRelated changesUpload fileSpecial pagesPermanent linkPage informationWikidata itemDownload as PDFPrintable versionEspañolفارسیFrançaisBahasa IndonesiaItalianoଓଡ଼ିଆPortuguêsසිංහලSlovenčinaSlovenščinaСрпски / srpskiTürkçeTiếng ViệtEdit links