Wiki source code of Readability Guidelines project

Version 6.106 by Lizzie Bruce on 2019/03/27 11:42

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