Changes for page Simple sentences

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

From 2.17 to 2.16 From 2.32 to 2.31

From version

2.31

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

Change comment: Update document after refactoring.

To version

2.17

edited by Lizzie Bruce
on 2019/03/07 13:14

Change comment: There is no comment for this version

Raw
Rendered

Summary

Page properties (3 modified, 0 added, 0 removed)

Details

Page properties

Title

@@ -1,1 +1,1 @@
--Simple sentences
++Clear language

Parent

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

Content

@@ -1,47 +1,28 @@
--(% class="box" %)
--(((
--Writing about people
--)))
++(% class="wikigeneratedid" %)
++This helps:
--(% class="box" %)
--(((
--Audience labels: using I, you, we, they
--)))
++* **people in a hurry** – simply written content is easier to scan and absorb instantly
++* **cognitive impairments** – easy to understand words and sentences need less cognition
++* **visual impairments** – short and simple sentences convey meaning in a smaller visual field
++* **motor impairments** – it's less tiring when you can understand what you read quickly
--(% class="box" %)
--(((
--== [[Plain English, specialist terms >>doc:.Plain English, simple sentences.WebHome]] ==
--)))
--(% class="box" %)
--(((
--Simple sentences
--)))
--(% class="box" %)
--(((
--Law, medicine and money
--)))
++== Guidelines ==
--(% class="box" %)
--(((
--Words to avoid
--)))
++[[Plain English>>Plain English||anchor="pe"]]
--[[Simple sentences>>||anchor="ssl"]]
++[[Simple sentences >>    ||anchor="ssl"]]
--[[Specialist terms>>||anchor="st"]]
++[[Specialist terms>>Specialist terms||anchor="st"]]
--[[Law, medicine, money>>doc:.Medical.WebHome]]
++(% class="wikigeneratedid" %)
++Words to avoid
  (% class="wikigeneratedid" %)
--[[Words to avoid>>doc:.Words to avoid.WebHome]]
++Medicine, money and law
------
--
--==   ==
--
  == {{id name="pe"/}}Plain English ==
  Make content clear and understandable, to open the web up for users with different literacy levels and access challenges.
@@ -78,7 +78,7 @@
  What is 'plain' for one person may not be for someone else.
--== Usability evidence: plain English ==
++== Usability evidence for 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.
@@ -97,20 +97,17 @@
  [[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.
++The maximum sentence length we would recommend for easy comprehension is 25 words.
--Oxford Guide to plain English, GOV.UK and linguists agree 15 word sentences are fine but above 40 words is hard to understand.
++You can split longer sentences up into 2 or 3 or restructure the content with bullet points to make meaning clearer for users.
--=== 2. Avoid complex sentence structures. ===
++== 2. Avoid complex sentence structures. ==
  They are less easy to comprehend quickly. Understanding them requires more cognitive effort than simple sentences.
@@ -125,14 +125,16 @@
  >"The fox, which was red, over the gate jumped." – harder to understand
--== Usability evidence: simple sentences ==
++== Usability evidence for simple sentences ==
--Oxford Guide to plain English
++"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
--Jyoti Sanyal 'Indlish'
++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."
--Author Ann Wylie
++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."
++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."
++
  [[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
@@ -174,17 +174,13 @@
  [[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: explain them ==
--==   ==
--
--== {{id name="st"/}}Specialist terms ==
--
  (% class="wikigeneratedid" %)
  Make specialist content comprehensible by non-experts.
--=== 1. Explain specialist terms: anybody can access your content. ===
++=== 1. Remember that anybody can access your content. ===
  Assuming who your audience is, and that they'll understand the technical terms you use, are common misconceptions.
@@ -206,14 +206,13 @@
  >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 stone building, and contains a number of splendid paintings and much fine wood-carving." – original sentence.
  >
  >"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 ==
++== Usability evidence for explaining specialist terms ==
  [['Writing Digital Copy for Domain Experts'>>url:https://www.nngroup.com/articles/writing-domain-experts/]], Nielson Norman Group, 2017
@@ -228,12 +228,14 @@
  [['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" %)
++We generated the [[before sentence about an architecture term>>url:http://sentence.yourdictionary.com/palladian]] from yourdictionary.com and applied our recommendations.
++
  (% class="wikigeneratedid" %)
--Here's some sector specific guidance for [[medicine, money and law>>doc:.Medical.WebHome]].
--
++Here's some sector specific guidance for medicine, money and law.
--And here's our list of jargon [[words to avoid>>doc:.Words to avoid.WebHome]]!
++{{children/}}
++
++

Changes for page Simple sentences

Summary

Details

Navigation