Changes for page Simple sentences
Last modified by Lizzie Bruce on 2020/01/11 23:51
From version 2.16
edited by Lizzie Bruce
on 2019/03/07 13:11
on 2019/03/07 13:11
Change comment:
There is no comment for this version
Summary
-
Page properties (4 modified, 0 added, 0 removed)
-
Objects (0 modified, 2 added, 0 removed)
Details
- Page properties
-
- Title
-
... ... @@ -1,1 +1,1 @@ 1 - Clearlanguage1 +Simple sentences - Parent
-
... ... @@ -1,1 +1,1 @@ 1 - Main.WebHome1 +Plain English.WebHome - Author
-
... ... @@ -1,1 +1,1 @@ 1 - xwiki:XWiki.LizzieBruce1 +XWiki.XWikiGuest - Content
-
... ... @@ -1,92 +1,53 @@ 1 -(% class="wikigeneratedid" %) 2 -This helps: 1 +(% class="box" %) 2 +((( 3 +Following this helps: 3 3 4 -* **people in a hurry** – simply written content is easier to scan and absorb instantly 5 -* **cognitive impairments** – easy to understand words and sentences need less cognition 6 -* **visual impairments** – short and simple sentences convey meaning in a smaller visual field 7 -* **motor impairments** – it's less tiring when you can understand what you read quickly 5 +* **people in a hurry** – simply written content is easier to scan and absorb instantly 6 +* **people who are stressed** – if you're anxious you find it harder to comprehend things 7 +* **people who are multi-tasking** – if you're distracted it's hard to comprehend convoluted structures 8 +* **cognitive impairments** – shorter, non-complex sentences carry less cognitive load 9 +* **visual impairments** – short, simple sentences convey meaning in a smaller visual field 10 +* **motor impairments** – clear, concise content is shorted so requires less navigation 11 +))) 8 8 13 +== 14 +Guidelines == 9 9 16 +Short, simple sentences are better on the web than long, protracted prose with complex syntax. WCAG says: "using the clearest and simplest language appropriate is highly desirable." 10 10 11 -== Guidelines == 12 12 13 -[[Plain English>>Plain English||anchor="pe"]] 19 +(% class="wikigeneratedid" id="H1.MakeyouraveragesentenceA015wordslong." %) 20 +[[1. Make your average sentence 15 words long.>>doc:||anchor="#1"]] 14 14 15 -[[Simple sentences >> ||anchor="ssl"]] 22 +(% class="wikigeneratedid" id="H2.A0Avoidcomplexsentencestructures." %) 23 +[[2. Avoid complex sentence structures.>>doc:||anchor="#2"]] 16 16 17 -[[Specialist terms>>Specialist terms||anchor="st"]] 18 - 19 19 (% class="wikigeneratedid" %) 20 -Words to avoid 26 +[[Usability evidence>>doc:||anchor="#UESS"]] 27 + 21 21 29 +---- 22 22 23 -== {{idname="pe"/}}PlainEnglish==31 +== == 24 24 25 -Make content clear and understandable,to openhewebup forusers withdifferent literacy levelsand access challenges.33 +=== {{id name="#1"/}}1. Make your average sentence 15 words long. === 26 26 27 - WCAGstatesthat"usingthe clearest andsimplestanguageappropriateishighlydesirable."35 +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. 28 28 29 -The United Nations recommends plain language for communications. 30 - 37 +Oxford Guide to plain English, GOV.UK and linguists agree: 31 31 32 -=== 1. Choose easy and short words not formal, long ones. === 33 - 34 -Use ‘buy’ instead of ‘purchase’, ‘help’ instead of ‘assist’, and ‘about’ instead of ‘approximately’. 35 - 36 -Write for the reading comprehension of a 9 year old. This helps you reach the most users and makes your content easy to scan. 39 +* 15 word sentences are more likely to be comprehensible 40 +* 25 words is a good maximum sentence length limit 41 +* above 40 words sentences are hard to comprehend easily 37 37 38 38 39 -=== 2. Jargon and buzzwords are unlikely to be clear language. === 40 - 41 -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. 42 - 43 - 44 44 Example: 45 -"Let's touch base in 10 and do some blue sky thinking." This uses jargon. 46 -"Let's meet in 10 minutes to think of some ideas." Conveys same meaning using clear language. 47 47 46 +(% class="mark" %)This sentence is about 15 words long and is easy to understand. (%%) 47 + 48 48 49 -=== 3. Write conversationally. ===49 +=== {{id name="#2"/}}2. Avoid complex sentence structures. === 50 50 51 -Picture your audience and write as if you were talking directly to them, with the authority of someone who can help and inform. 52 - 53 - 54 -=== 4. Test your content with users === 55 - 56 -What is 'plain' for one person may not be for someone else. 57 - 58 - 59 -== Usability evidence for plain English == 60 - 61 -[[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. 62 - 63 -[['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. 64 - 65 -[['Plain Language Is for Everyone, Even Experts'>>url:https://www.nngroup.com/articles/plain-language-experts/]], H. Loranger, Nielsen Norman Group, 2017 66 - 67 -[['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 68 - 69 -[['Strengthening plain language'>>url:http://www.iplfederation.org/]], International Plain Language Federation. Undated. 70 - 71 -[[Plain Language Commission style guide>>url:https://www.clearest.co.uk/plain-language-commission-style-guide]], Plain Language Commission, 2011 72 - 73 -[['The principles of readability'>>url:http://www.impact-information.com/impactinfo/readability02.pdf]], Impact Information, William H. DuBay, 2004 74 - 75 -[[Plain language entry>>url:https://en.m.wikipedia.org/wiki/Plain_language]], Wikipedia, last updated 2018 76 - 77 - 78 -== {{id name="ssl"/}}Simple sentences == 79 - 80 - 81 -=== 1. Make your average sentence 15 words long. === 82 - 83 -The maximum sentence length we would recommend for easy comprehension is 25 words. 84 - 85 -You can split longer sentences up into 2 or 3 or restructure the content with bullet points to make meaning clearer for users. 86 - 87 - 88 -== 2. Avoid complex sentence structures. == 89 - 90 90 They are less easy to comprehend quickly. Understanding them requires more cognitive effort than simple sentences. 91 91 92 92 ... ... @@ -96,20 +96,17 @@ 96 96 * distribution of associated words across the sentence – how easily can the brain 'parse a phrase': recognise, connect and comprehend words that together convey meaning 97 97 98 98 99 ->Example:"The red fox jumped over the gate." – easier to understand 100 ->"The fox, which was red, over the gate jumped." – harder to understand 60 +Example: 61 +\\(% class="mark" %)"The red fox jumped over the gate." – easier to understand 62 +"The fox, which was red, over the gate jumped." – harder to understand 101 101 102 102 103 - == Usability evidence for simple sentences ==65 +---- 104 104 105 - "Peoplewith some learningdisabilitiesread letter for letter – they donot bouncearound like other users. They also cannot fully understand a sentence if it’s too long. People withmoderate learning disabilitiescan understandsentencesof 5 to 8 wordswithout difficulty. By using common words we can helpall usersunderstand sentencesof around 25 words." GOV.UK67 +== {{id name="#UESS"/}}Usability evidence: simple sentences == 106 106 107 - TheOxford Guide toPlain Englishrecommends 15–20 words persentence. Italsosays: "…ifyouregularlyexceed40 words,you’ll certainly weary and deteryourreaders."69 +[[Oxford Guide to plain English>>https://global.oup.com/academic/product/oxford-guide-to-plain-english-9780199669172?cc=gb&lang=en&]] , Oxford University Press, 2013 108 108 109 -Jyoti Sanyal, author of 'Indlish' said: "Based on several studies, press associations in the USA have laid down a readability table. Their survey shows readers find sentences of 8 words or less very easy to read; 11 words, easy; 14 words fairly easy; 17 words standard; 21 words fairly difficult; 25 words difficult and 29 words or more, very difficult." 110 - 111 -Author Ann Wylie said: "When the average sentence length in a piece was fewer than 8 words long, readers understood 100% of the story. At 14 words, they could comprehend more than 90% of the information. But move up to 43-word sentences and comprehension dropped below 10 percent." 112 - 113 113 [[Writing for GOV.UK>>url:https://www.gov.uk/guidance/content-design/writing-for-gov-uk]], UK Government website 114 114 115 115 [['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 ... ... @@ -116,8 +116,12 @@ 116 116 117 117 [['Content design'>>url:https://contentdesign.london/book/]], Sarah Richards, 2017 118 118 119 -[[' The role of word difficultyandsentencelengthintextcomprehension'>>url:https://apps.dtic.mil/dtic/tr/fulltext/u2/a114935.pdf]], T.M. Duffy andP.K. U'Ren,198277 +[['Short sentences boost readability. Nearly 140 years of research proves it'>>https://www.wyliecomm.com/2018/08/short-sentences-boost-readability/]] A. Wylie, a collection of studies since 1880s, 2018 120 120 79 +[['Indlish: The book for every English-speaking Indian'>>http://www.vivagroupindia.com/frmBookDetail.aspx?BookId=5020&Status=C]], J. Sanyal, 2006. Book. 80 + 81 +[['The role of word difficulty and sentence length in text comprehension'>>https://eric.ed.gov/?id=ED215330]], T. M. Duffy and P. K. U'Ren, 1982 82 + 121 121 [['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 122 122 123 123 [['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 ... ... @@ -128,7 +128,7 @@ 128 128 129 129 [['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 130 130 131 -[['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]], K arenSchriver, PhD, Dr. A. L. Cheek, M. Mercer, Center for Plain Language, November 20, 2008, Mexico City93 +[['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]], K. Schriver, PhD, Dr. A. L. Cheek, M. Mercer, Center for Plain Language, November 20, 2008, Mexico City 132 132 133 133 [['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 134 134 ... ... @@ -136,89 +136,29 @@ 136 136 137 137 [[Plain Language Commission style guide>>url:https://irp-cdn.multiscreensite.com/aaf9e928/files/uploaded/PLCstyleguide25July2012.pdf]], 2012 138 138 139 -[['Shorter Lines Facilitate Reading in Those Who Struggle'>>url:https://journals.plos.org/plosone/article?id=10.1371/journal.pone.0071161]], M atthewH. Schneps , JennyM. Thomson, GerhardSonnert, MarcPomplun, ChenChen, AmandaHeffner-Wong, 2013101 +[['Shorter Lines Facilitate Reading in Those Who Struggle'>>url:https://journals.plos.org/plosone/article?id=10.1371/journal.pone.0071161]], M. H. Schneps , J. M. Thomson, G. Sonnert, M. Pomplun, C. Chen, A. Heffner-Wong, 2013 140 140 141 -[['Towards a better measure of readability: Explanation of empirical performance results'>>url:https://www.tandfonline.com/doi/pdf/10.1080/00437956.1989.11435805]], L eslieA. Olsen&RodJohnson, Taylor&Francis Group, 2015103 +[['Towards a better measure of readability: Explanation of empirical performance results'>>url:https://www.tandfonline.com/doi/pdf/10.1080/00437956.1989.11435805]], L. A. Olsen, R. Johnson, Taylor and Francis Group, 2015 142 142 143 143 [['What is plain language?'>>url:https://plainlanguagenetwork.org/plain-language/what-is-plain-language/]], Plain Language Association International, 2015 144 144 145 145 [[Text complexity, ATOS, and Lexile® Measures>>url:https://www.renaissance.com/products/practice/accelerated-reader-360/atos-and-text-complexity/]], Renaissance Learning, 2016 146 146 147 -[['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 109 +[['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]] E. Kirkpatrick, W. Gaisford, E. Williams, E. Brindley, D. Tembo, D. Wright, 2017 148 148 149 -[['How to use Yoast SEO: The readability analysis?'>>url:https://yoast.com/yoast-seo-readability-analysis/]] E dwinToonen, Yoast, 2018111 +[['How to use Yoast SEO: The readability analysis?'>>url:https://yoast.com/yoast-seo-readability-analysis/]] E. Toonen, Yoast, 2018 150 150 151 -[[The Crystal Mark standard>>url:http://www.plainenglish.co.uk/services/crystal-mark/7-the-crystal-mark-standard.html]] Plain English Campaign ,undated113 +[[The Crystal Mark standard>>url:http://www.plainenglish.co.uk/services/crystal-mark/7-the-crystal-mark-standard.html]] Plain English Campaign. Undated. 152 152 153 153 154 - == {{id name="st"/}}Specialist terms: explain them ==116 +---- 155 155 156 -(% class="wikigeneratedid" %) 157 -Make specialist content comprehensible by non-experts. 118 +(% class="box" %) 119 +((( 120 +See also: 158 158 159 - 160 -=== 1. Remember that anybody can access your content. === 161 - 162 -Assuming who your audience is, and that they'll understand the technical terms you use, are common misconceptions. 163 - 164 - 165 -=== 2. Create content that all users can understand, whatever their expertise or background. === 166 - 167 -When you present a concept explain its parts and processes in detail. 168 - 169 -If you need to include a technical term consider explaining it. Make sure the surrounding language in plain language. 170 - 171 - 172 -=== 3. Help users understand specialist terms. === 173 - 174 -You could: 175 - 176 -* link to an existing definition – this could be an external site 177 -* add a explanatory definition after using the term 178 - 179 - 180 ->Example: 181 -> 182 ->"It is a Palladian style stone building, and contains a number of splendid paintings and much fine wood-carving." – original sentence. 183 -> 184 ->"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. 185 -> "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. 186 - 187 - 188 -== Usability evidence for explaining specialist terms == 189 - 190 -[['Writing Digital Copy for Domain Experts'>>url:https://www.nngroup.com/articles/writing-domain-experts/]], Nielson Norman Group, 2017 191 - 192 -[['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 193 - 194 -[['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 195 - 196 -[['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 197 - 198 -[['Advantages and disadvantages with Simplified Technical English'>>url:https://liu.diva-portal.org/smash/get/diva2:16816/FULLTEXT01]], Msc thesis paper, Karin Disborg, 2007 199 - 200 -[['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 201 - 202 -[['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 203 - 204 -(% class="wikigeneratedid" %) 205 -We generated the [[before sentence about an architecture term>>url:http://sentence.yourdictionary.com/palladian]] from yourdictionary.com and applied our recommendations. 206 - 207 - 208 -(% class="wikigeneratedid" %) 209 -Here's some sector specific guidance: 210 - 211 -(% class="wikigeneratedid" %) 212 -Legal 213 - 214 -(% class="wikigeneratedid" %) 215 -Medical 216 - 217 -(% class="wikigeneratedid" %) 218 -Financial 219 - 220 - 221 -{{children/}} 222 - 223 - 224 - 122 +* [[Plain English>>doc:Plain English.Plain English, simple sentences.WebHome]] 123 +* [[Specialist terms>>doc:Plain English.Specialist terms.WebHome]] 124 +* [[Law, medicine, money>>doc:Plain English.Medical.WebHome]] 125 +* [[Words to avoid>>doc:Plain English.Words to avoid.WebHome]] 126 +)))
- XWiki.XWikiComments[0]
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +Chris in Oslo - Comment
-
... ... @@ -1,0 +1,1 @@ 1 +It's my experience that when you say to people "X should be on average Y long", they hear "X should be at least Y long". They get hung up on the number and think they have to reach it. I could absolutely imagine that people who are not experienced (usually exactly the ones who want clear and explicit guidance) will see this and make sentences *longer* because theirs is only 10 words. TL;DR: I don't think is bad advice, but I do think people are bad at averaging and bad at understanding that X limit does not mean "write X much" :) - Date
-
... ... @@ -1,0 +1,1 @@ 1 +2019-05-03 15:47:13.0
- 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.839