Changes for page Simple sentences

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

From version Icon 2.16 Icon
edited by Lizzie Bruce
on 2019/03/07 13:11
Change comment: There is no comment for this version
To version Icon 2.31 Icon
edited by Lizzie Bruce
on 2019/03/08 20:53
Change comment: Update document after refactoring.

Summary

Details

Icon Page properties
Title
... ... @@ -1,1 +1,1 @@
1 -Clear language
1 +Simple sentences
Parent
... ... @@ -1,1 +1,1 @@
1 -Main.WebHome
1 +Plain English.WebHome
Content
... ... @@ -1,25 +1,47 @@
1 -(% class="wikigeneratedid" %)
2 -This helps:
1 +(% class="box" %)
2 +(((
3 +Writing about people
4 +)))
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
6 +(% class="box" %)
7 +(((
8 +Audience labels: using I, you, we, they
9 +)))
8 8  
11 +(% class="box" %)
12 +(((
13 +== [[Plain English, specialist terms >>doc:.Plain English, simple sentences.WebHome]] ==
14 +)))
9 9  
16 +(% class="box" %)
17 +(((
18 +Simple sentences
19 +)))
10 10  
11 -== Guidelines ==
21 +(% class="box" %)
22 +(((
23 +Law, medicine and money
24 +)))
12 12  
13 -[[Plain English>>Plain English||anchor="pe"]]
26 +(% class="box" %)
27 +(((
28 +Words to avoid
29 +)))
14 14  
15 -[[Simple sentences >> ||anchor="ssl"]]
31 +[[Simple sentences>>||anchor="ssl"]]
16 16  
17 -[[Specialist terms>>Specialist terms||anchor="st"]]
33 +[[Specialist terms>>||anchor="st"]]
18 18  
35 +[[Law, medicine, money>>doc:.Medical.WebHome]]
36 +
19 19  (% class="wikigeneratedid" %)
20 -Words to avoid
38 +[[Words to avoid>>doc:.Words to avoid.WebHome]]
21 21  
22 22  
41 +----
42 +
43 +== ==
44 +
23 23  == {{id name="pe"/}}Plain English ==
24 24  
25 25  Make content clear and understandable, to open the web up for users with different literacy levels and access challenges.
... ... @@ -56,7 +56,7 @@
56 56  What is 'plain' for one person may not be for someone else.
57 57  
58 58  
59 -== Usability evidence for plain English ==
81 +== Usability evidence: plain English ==
60 60  
61 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 62  
... ... @@ -75,17 +75,20 @@
75 75  [[Plain language entry>>url:https://en.m.wikipedia.org/wiki/Plain_language]], Wikipedia, last updated 2018
76 76  
77 77  
78 -== {{id name="ssl"/}}Simple sentences ==
100 +----
79 79  
102 +== ==
80 80  
104 +== {{id name="ssl"/}}Simple sentences ==
105 +
81 81  === 1. Make your average sentence 15 words long. ===
82 82  
83 -The maximum sentence length we would recommend for easy comprehension is 25 words.
108 +The maximum sentence length for a good leveof comprehension is 25 words. Split long sentences up into 2 or 3, or use bullet points.
84 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.
110 +Oxford Guide to plain English, GOV.UK and linguists agree 15 word sentences are fine but above 40 words is hard to understand.
86 86  
87 87  
88 -== 2. Avoid complex sentence structures. ==
113 +=== 2. Avoid complex sentence structures. ===
89 89  
90 90  They are less easy to comprehend quickly. Understanding them requires more cognitive effort than simple sentences.
91 91  
... ... @@ -100,16 +100,14 @@
100 100  >"The fox, which was red, over the gate jumped." – harder to understand
101 101  
102 102  
103 -== Usability evidence for simple sentences ==
128 +== Usability evidence: simple sentences ==
104 104  
105 -"People with some learning disabilities read letter for letter – they do not bounce around like other users. They also cannot fully understand a sentence if it’s too long. People with moderate learning disabilities can understand sentences of 5 to 8 words without difficulty. By using common words we can help all users understand sentences of around 25 words." GOV.UK
130 +Oxford Guide to plain English
106 106  
107 -The Oxford Guide to Plain English recommends 15–20 words per sentence. It also says: "…if you regularly exceed 40 words, you’ll certainly weary and deter your readers."
132 +Jyoti Sanyal 'Indlish'
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."
134 +Author Ann Wylie
110 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
... ... @@ -151,13 +151,17 @@
151 151  [[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 ==
177 +----
155 155  
179 +== ==
180 +
181 +== {{id name="st"/}}Specialist terms ==
182 +
156 156  (% class="wikigeneratedid" %)
157 157  Make specialist content comprehensible by non-experts.
158 158  
159 159  
160 -=== 1. Remember that anybody can access your content. ===
187 +=== 1. Explain specialist terms: anybody can access your content. ===
161 161  
162 162  Assuming who your audience is, and that they'll understand the technical terms you use, are common misconceptions.
163 163  
... ... @@ -179,13 +179,14 @@
179 179  
180 180  >Example:
181 181  >
182 ->"It is a Palladian style stone building, and contains a number of splendid paintings and much fine wood-carving." – original sentence.
209 +>"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]]).
183 183  >
184 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.
212 +>
185 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 186  
187 187  
188 -== Usability evidence for explaining specialist terms ==
216 +== Usability evidence: specialist terms ==
189 189  
190 190  [['Writing Digital Copy for Domain Experts'>>url:https://www.nngroup.com/articles/writing-domain-experts/]], Nielson Norman Group, 2017
191 191  
... ... @@ -200,25 +200,12 @@
200 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 201  
202 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
231 +
203 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.
233 +----
206 206  
207 -
208 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 -
236 +Here's some sector specific guidance for [[medicine, money and law>>doc:.Medical.WebHome]].
224 224  
238 +
239 +And here's our list of jargon [[words to avoid>>doc:.Words to avoid.WebHome]]!