Wiki source code of Readability Guidelines project
Version 6.106 by Lizzie Bruce on 2019/03/27 11:42
Show last authors
author | version | line-number | content |
---|---|---|---|
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/]] |