Wiki source code of Readability Guidelines

Version 8.5 by Lizzie Bruce on 2019/04/05 17:33

Show last authors
1 (% class="box" %)
2 A project from [[Content Design London>>http://contentdesign.London]].
3 \\"Imagine a collaboratively developed, universal content style guide, based on usability evidence. With guidelines for creating easy to comprehend content, we'll design inclusively by default." – Sarah Richards
4
5 (% class="box" %)
6 (((
7 **[[Clear language>>doc:Plain English.WebHome]]**
8 )))
9
10 (% class="box" %)
11 **[[Grammar points>>doc:Punctuation and abbreviating.WebHome]]**
12
13 (% class="box" %)
14 **[[Audiences>>doc:People.WebHome]]**
15
16 (% class="box" %)
17 **[[Content design>>doc:User centred design.WebHome]]**
18
19 ==
20 {{id name="#W"/}}The project ==
21
22 In 2018 Sarah Richards at Content Design London asked if, working together, we can create a [[universal, inclusive style guide>>url:https://contentdesign.london/blog/usability/readability-guidelines]]. Because 'style guide' can mean different things, we called it the 'readability guidelines' project.
23
24 Content professionals in multiple sectors held regular discussions across the globe for 24 weeks. This was [[Alpha>>||anchor="Alpha"]] and [[Beta>>||anchor="Beta"]]. And it's all continuing: you can [[get involved>>||anchor="Gi"]].
25
26
27 (% class="box" %)
28 (((
29 [[Top findings>>doc:.Top findings.WebHome]]
30 )))
31
32 (% class="box" %)
33 (((
34 [[Our usability questions>>doc:.Usability questions.WebHome]]
35 )))
36
37 (% class="box" %)
38 (((
39 [[Testing we want to do>>doc:.New research.WebHome]]
40 )))
41
42 === (% style="color:inherit; font-family:inherit; font-size:26px" %){{id name="Alpha"/}}(%%)Alpha ===
43
44 We asked if:
45
46 (((
47 * an open community of content people want to contribute to a single style guide
48 * we'd like to rely on evidence for the style guide elements – and if yes, what evidence would be most useful
49 * a wiki model is sustainable
50 )))
51
52 Read the [[final Alpha blog update>>https://contentdesign.london/research/readability-alpha-the-end/]].
53
54 Alpha ran from July to October, 2018.
55
56
57 === {{id name="Beta"/}}Beta ===
58
59 From the Alpha discussions we identified 17 content style [[usability questions>>doc:.Usability questions.WebHome]]. We searched for evidence to answer them in Beta.
60
61 By the end we created the first readability guidelines, identified [[top level findings>>doc:Main.Top findings.WebHome]] and accepted that some style points needed further testing.
62
63 Read the [[final Beta blog update>>url:https://contentdesign.london/content-process/readability-guidelines-beta-update-4-by-lizzie-bruce/]].
64
65 Beta was October to December 2018.
66
67
68 (% class="box" %)
69 (((
70 == {{id name="Gi"/}}Get involved ==
71
72 Explore and join us:
73
74 (((
75 * read the global Slack discussions: [[readabilityguidelines.slack.com>>url:https://readabilityguidelines.slack.com/]], join: [[bit.ly/2D0OW1F>>url:https://bit.ly/2D0OW1F]]
76 * watch the London Accessibility MeetUp [[Readability Guidelines talk>>url:https://www.youtube.com/watch?v=PQzdtE8JQOs]]'
77 * share usability studies and academic research evidence on this wiki
78 * follow #ReadabilityGuidelines on Twitter and LinkedIn
79
80 We have almost 500 members in our Slack community.
81
82 )))
83
84 == Editing the wiki ==
85
86 This is a totally open project – dive in! You're welcome to comment on, edit or create wiki pages. The only rules are:
87
88 * be respectful
89 * make any comments in the spirit of positive open learning
90 * read the wiki pages carefully, and study existing evidence, before making comments and edits
91 * include usability evidence to support any edits
92
93 You can comment on any page without logging in. But if you'd like to add usability evidence please [[request a log-in>>mailto:lizzie@contentdesign.london]].
94
95 It may take a few days for us to set up your wiki account.
96
97 Any comments or queries outside of this wiki, please get in touch on twitter [[@ContentDesignLN>>url:https://readabilityguidelines.slack.com]].
98 )))
99
100 ==
101 Wiki sections ==
102
103 * [[Clear language>>path:/xwiki/bin/view/Plain%20English/]]
104 * [[Grammar points>>path:/xwiki/bin/view/Punctuation%20and%20abbreviating/]]
105 * [[Audiences>>path:/xwiki/bin/view/Audience%20descriptors/]] 
106 * [[Content design>>path:/xwiki/bin/view/User%20centred%20design/]]