Changes for page Simple sentences

Last modified by Lizzie Bruce on 2020/01/11 23:51

From 2.26 to 2.27 From 6.2 to 6.3

From version

2.27

edited by Lizzie Bruce
on 2019/03/08 20:44

Change comment: There is no comment for this version

To version

6.2

edited by Lizzie Bruce
on 2020/01/11 23:51

Change comment: Deleted object

Raw
Rendered

Summary

Page properties (3 modified, 0 added, 0 removed)
Objects (0 modified, 2 added, 0 removed)
- XWiki.XWikiComments[1]
- XWiki.XWikiComments[2]

Details

Page properties

Title

@@ -1,1 +1,1 @@
--Language use
++Simple sentences

Parent

@@ -1,1 +1,1 @@
--Main.WebHome
++Plain English.WebHome

Content

@@ -1,239 +1,1 @@
--(% class="box" %)
--(((
--Writing about people: being inclusive
--)))
--
--(% class="box" %)
--(((
--Audience labels: I, you, we, they
--)))
--
--(% class="box" %)
--(((
--Plain English, simple sentences
--)))
--
--(% class="box" %)
--(((
--Specialist terms
--)))
--
--(% class="box" %)
--(((
--Law, medicine and money
--)))
--
--(% class="box" %)
--(((
--Words to avoid
--)))
--
--[[Simple sentences>>||anchor="ssl"]]
--
--[[Specialist terms>>||anchor="st"]]
--
--[[Law, medicine, money>>doc:.Medical.WebHome]]
--
--(% class="wikigeneratedid" %)
--[[Words to avoid>>doc:.Words to avoid.WebHome]]
--
--
------
--
--==   ==
--
--== {{id name="pe"/}}Plain English ==
--
--Make content clear and understandable, to open the web up for users with different literacy levels and access challenges.
--
--WCAG states that "using the clearest and simplest language appropriate is highly desirable."
--
--The United Nations recommends plain language for communications.
--
--
--=== 1. Choose easy and short words not formal, long ones. ===
--
--Use ‘buy’ instead of ‘purchase’, ‘help’ instead of ‘assist’, and ‘about’ instead of ‘approximately’.
--
--Write for the reading comprehension of a 9 year old. This helps you reach the most users and makes your content easy to scan.
--
--
--=== 2. Jargon and buzzwords are unlikely to be clear language. ===
--
--Often, these words are too general and vague and can lead to misinterpretation or empty, meaningless text. Avoid them. Instead, think about what the term actually means and describe that. Be open and specific.
--
--
--Example:
--"Let's touch base in 10 and do some blue sky thinking." This uses jargon.
--"Let's meet in 10 minutes to think of some ideas." Conveys same meaning using clear language.
--
--
--=== 3. Write conversationally. ===
--
--Picture your audience and write as if you were talking directly to them, with the authority of someone who can help and inform.
--
--
--=== 4. Test your content with users ===
--
--What is 'plain' for one person may not be for someone else.
--
--
--== Usability evidence: plain English ==
--
--[[Guideline 3.1 Readable: Make text content readable and understandable.>>url:https://www.w3.org/TR/UNDERSTANDING-WCAG20/meaning-supplements.html]], Web Content Accessibility Guidelines (WCAG) 2.0, 2008.
--
--[['Convention on the Rights of Persons with Disabilities'>>url:http://templatelab.com/convention-on-the-rights-of-persons-with-disabilities/]], page 4 Article 2, Definitions, The United Nations Convention on the Rights of Persons with Disabilities, 2018.
--
--[['Plain Language Is for Everyone, Even Experts'>>url:https://www.nngroup.com/articles/plain-language-experts/]], H. Loranger, Nielsen Norman Group, 2017
--
--[['The Public Speaks: An Empirical Study of Legal Communication'>>url:https://papers.ssrn.com/sol3/papers.cfm?abstract_id=1843415]], C. R. Trudeau in 14 Scribes J. Leg. Writing 121 2012
--
--[['Strengthening plain language'>>url:http://www.iplfederation.org/]], International Plain Language Federation. Undated.
--
--[[Plain Language Commission style guide>>url:https://www.clearest.co.uk/plain-language-commission-style-guide]], Plain Language Commission, 2011
--
--[['The principles of readability'>>url:http://www.impact-information.com/impactinfo/readability02.pdf]], Impact Information, William H. DuBay, 2004
--
--[[Plain language entry>>url:https://en.m.wikipedia.org/wiki/Plain_language]], Wikipedia, last updated 2018
--
--
------
--
--==   ==
--
--== {{id name="ssl"/}}Simple sentences ==
--
--=== 1. Make your average sentence 15 words long. ===
--
--The maximum sentence length for a good level of comprehension is 25 words. Split long sentences up into 2 or 3, or use bullet points.
--
--Oxford Guide to plain English, GOV.UK and linguists agree 15 word sentences are fine but above 40 words is hard to understand.
--
--
--=== 2. Avoid complex sentence structures. ===
--
--They are less easy to comprehend quickly. Understanding them requires more cognitive effort than simple sentences.
--
--
--Complexity depends on:
--
--* number of clauses in a sentence, the more clauses the more complex it is
--* distribution of associated words across the sentence – how easily can the brain 'parse a phrase': recognise, connect and comprehend words that together convey meaning
--
--
-->Example:"The red fox jumped over the gate." – easier to understand
-->"The fox, which was red, over the gate jumped." – harder to understand
--
--
--== Usability evidence: simple sentences ==
--
--Oxford Guide to plain English
--
--Jyoti Sanyal 'Indlish'
--
--Author Ann Wylie
--
--[[Writing for GOV.UK>>url:https://www.gov.uk/guidance/content-design/writing-for-gov-uk]], UK Government website
--
--[['Sentence length: why 25 words is our limit'>>url:https://insidegovuk.blog.gov.uk/2014/08/04/sentence-length-why-25-words-is-our-limit/]], Inside GOV.UK, UK Government blog, 2014
--
--[['Content design'>>url:https://contentdesign.london/book/]], Sarah Richards, 2017
--
--[['The role of word difficulty and sentence length in text comprehension'>>url:https://apps.dtic.mil/dtic/tr/fulltext/u2/a114935.pdf]], T. M. Duffy and P. K. U'Ren, 1982
--
--[['The Influence of Semantics and Syntax on What Readers Remember'>>url:https://www.hcde.washington.edu/files/people/docs/Isakson_Spyridakis_Sem_Syn.pdf]], C. S. Isakson and J. H. Spyridakis, 1999
--
--[['How the brain attunes to sentence processing: Relating behavior, structure, and function'>>url:https://www.ncbi.nlm.nih.gov/pmc/articles/PMC4819595/]], A. Fengler, L. Meyer, A. D. Friederici, National Center for Biotechnology Information
--
--[['Functional Analysis of Clause Complex in the Language of News Websites Texts: A Comparative Study of Two Articles'>>url:http://www.ijsrp.org/research-paper-0616/ijsrp-p5445.pdf]], F. M. S. Eid, International Journal of Scientific and Research Publications, Volume 6, Issue 6, June 2016
--
--[[Reading Level>>url:https://www.w3.org/TR/UNDERSTANDING-WCAG20/meaning-supplements.html]], Understanding SC 3.1.5, WCAG, 2008
--
--[['Readability Assessment of Internet-Based Consumer Health Information'>>url:http://rc.rcjournal.com/content/53/10/1310/tab-pdf]], T. M. Walsh and T. A. Volsko in Respiratory Care October 2008, 53 (10) 1310-1315
--
--[['The research basis of plain language techniques: Implications for establishing standards'>>url:https://www.researchgate.net/profile/Karen_Schriver/publication/285927928_The_research_basis_of_plain_language_techniques_Implications_for_establishing_standards/links/5664c50208ae192bbf90aa85/The-research-basis-of-plain-language-techniques-Implications-for-establishing-standards.pdf]], Karen Schriver, PhD, Dr. A. L. Cheek, M. Mercer, Center for Plain Language, November 20, 2008, Mexico City
--
--[['Readability Levels of Health-Based Websites: From Content to Comprehension'>>url:https://files.eric.ed.gov/fulltext/EJ851863.pdf]], M. Schutten, A. McFarland, PhD, International Electronic Journal of Health Education, 2009, 12:99-107
--
--[['Writing smaller'>>url:http://clarity-international.net/journals/63.pdf]], Clarity Journal no. 63, 2010
--
--[[Plain Language Commission style guide>>url:https://irp-cdn.multiscreensite.com/aaf9e928/files/uploaded/PLCstyleguide25July2012.pdf]], 2012
--
--[['Shorter Lines Facilitate Reading in Those Who Struggle'>>url:https://journals.plos.org/plosone/article?id=10.1371/journal.pone.0071161]], Matthew H. Schneps , Jenny M. Thomson, Gerhard Sonnert, Marc Pomplun, Chen Chen, Amanda Heffner-Wong, 2013
--
--[['Towards a better measure of readability: Explanation of empirical performance results'>>url:https://www.tandfonline.com/doi/pdf/10.1080/00437956.1989.11435805]], Leslie A. Olsen & Rod Johnson, Taylor & Francis Group, 2015
--
--[['What is plain language?'>>url:https://plainlanguagenetwork.org/plain-language/what-is-plain-language/]], Plain Language Association International, 2015
--
--[[Text complexity, ATOS, and Lexile® Measures>>url:https://www.renaissance.com/products/practice/accelerated-reader-360/atos-and-text-complexity/]], Renaissance Learning, 2016
--
--[['Understanding Plain English summaries. A comparison of two approaches to improve the quality of Plain English summaries in research reports.'>>url:https://researchinvolvement.biomedcentral.com/articles/10.1186/s40900-017-0064-0]] 2017
--
--[['How to use Yoast SEO: The readability analysis?'>>url:https://yoast.com/yoast-seo-readability-analysis/]] Edwin Toonen, Yoast, 2018
--
--[[The Crystal Mark standard>>url:http://www.plainenglish.co.uk/services/crystal-mark/7-the-crystal-mark-standard.html]] Plain English Campaign, undated
--
--
------
--
--==   ==
--
--== {{id name="st"/}}Specialist terms ==
--
--(% class="wikigeneratedid" %)
--Make specialist content comprehensible by non-experts.
--
--
--=== 1. Explain specialist terms: anybody can access your content. ===
--
--Assuming who your audience is, and that they'll understand the technical terms you use, are common misconceptions.
--
--
--=== 2. Create content that all users can understand, whatever their expertise or background. ===
--
--When you present a concept explain its parts and processes in detail.
--
--If you need to include a technical term consider explaining it. Make sure the surrounding language in plain language.
--
--
--=== 3. Help users understand specialist terms. ===
--
--You could:
--
--* link to an existing definition – this could be an external site
--* add a explanatory definition after using the term
--
--
-->Example:
-->
-->"It is a Palladian style stone building, and contains a number of splendid paintings and much fine wood-carving." – original sentence (source [[yourdictionary.com>>url:http://sentence.yourdictionary.com/palladian]]).
-->
-->"It is a [[Palladian style>>url:http://www.vam.ac.uk/content/articles/s/style-guide-palladianism/]] stone building, and contains a number of splendid paintings and much fine wood-carving." – with link to a definition.
-->
--> "It is a Palladian style stone building and contains a number of splendid paintings and much fine wood-carving. Palladian style architecture features include columns, symmetry and decorative arches." – with explanatory definition.
--
--
--== Usability evidence: specialist terms ==
--
--[['Writing Digital Copy for Domain Experts'>>url:https://www.nngroup.com/articles/writing-domain-experts/]], Nielson Norman Group, 2017
--
--[['Writing Digital Copy for Specialists vs. General Audiences'>>url:https://www.nngroup.com/videos/writing-digital-copy-specialists/?lm=how-users-read-on-the-web&pt=article]], Nielson Norman Group, undated
--
--[['Plain Language For Everyone, Even Experts'>>url:https://www.nngroup.com/videos/plain-language-for-experts/?lm=how-users-read-on-the-web&pt=article]] Nielson Norman Group, undated
--
--[['TechWhirl Fast 5: Understanding Plain Language and Simplified Technical English'>>url:https://techwhirl.com/techwhirl-fast-5-understanding-plain-language-simplified-technical-english/]], Connie Giordano, TechWhirl, 2017
--
--[['Advantages and disadvantages with Simplified Technical English'>>url:https://liu.diva-portal.org/smash/get/diva2:16816/FULLTEXT01]], Msc thesis paper, Karin Disborg, 2007
--
--[['Technical Writing Need Not Be Abstruse—Use Plain Language for Maximum Impact'>>url:https://digital.gov/2015/10/23/technical-writing-need-not-be-abstruse-use-plain-language-for-maximum-impact/#]], Colleen Blessing, 2015
--
--[['The Facets of the General Public as Audience'>>url:https://www.dropbox.com/s/2u2cybl7c57u0tr/AudienceIssues.pdf?dl=0]] Cheryl Stephens and Mariah Stufflebeam, 2017
--
--
------
--
--(% class="wikigeneratedid" %)
--Here's some sector specific guidance for [[medicine, money and law>>doc:.Medical.WebHome]].
--
--
--And here's our list of jargon [[words to avoid>>doc:.Words to avoid.WebHome]]!
++Please go to [[readabilityguidelines.co.uk/clear-language/simple-sentences>>url:https://readabilityguidelines.co.uk/clear-language/simple-sentences/]].

XWiki.XWikiComments[1]

Author

...	...	@@ -1,0 +1,1 @@
	1	+Chris in Oslo again

Comment

...	...	@@ -1,0 +1,1 @@
	1	+I'm trying to think about how I would write guidelines in a way that would mitigate what I wrote above. My experience has been that people remember the number much better than the precise thing you were trying to convey with the number (which is why we have truthy-but-wrong memes like "you only use 10% of your brain.) I guess I'm missing something above that says "Make sentences as short as possible by introducing one idea at a time" or similar?

Date

...	...	@@ -1,0 +1,1 @@
	1	+2019-05-03 15:53:50.0

XWiki.XWikiComments[2]