Wiki source code of Readability Guidelines

Version 14.5 by Lizzie Bruce on 2019/12/05 09:28

version	line-number	content
6.66	1	(% class="box" %)
8.4	2	A project from [[Content Design London>>http://contentdesign.London]].
14.2	3	\\"Imagine a collaboratively developed, universal content style guide, based on usability evidence. With guidelines for creating easy to comprehend content, we can design inclusively by default." – Sarah Richards
6.82	4
	5	(% class="box" %)
6.66	6	(((
6.92	7	[[Clear language>>doc:Plain English.WebHome]]
6.66	8	)))
	9
6.88	10	(% class="box" %)
6.91	11	[[Grammar points>>doc:Punctuation and abbreviating.WebHome]]
6.88	12
	13	(% class="box" %)
14.1	14	[[Audiences, devices, channels>>doc:People.WebHome]]
6.88	15
	16	(% class="box" %)
6.91	17	[[Content design>>doc:User centred design.WebHome]]
6.88	18
6.21	19	==
6.86	20	{{id name="#W"/}}The project ==
6.1	21
10.1	22	In 2018 Sarah Richards 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.
6.20	23
10.5	24	Content professionals in multiple sectors held regular global discussions for a total of 24 weeks. This was [[Alpha>>\|\|anchor="Alpha"]] and [[Beta>>\|\|anchor="Beta"]]. And it's all continuing: you can [[get involved>>\|\|anchor="Gi"]].
6.65	25
6.61	26
6.87	27	(% class="box" %)
	28	(((
14.3	29	[[Checklist>>doc:.Readability checklist.WebHome]]
6.87	30	)))
	31
	32	(% class="box" %)
	33	(((
14.3	34	[[Top findings>>doc:.Top findings.WebHome\|\|style="background-color: rgb(245, 245, 245);"]]
	35	)))
	36
	37	(% class="box" %)
	38	(((
6.87	39	[[Our usability questions>>doc:.Usability questions.WebHome]]
	40	)))
	41
	42	(% class="box" %)
	43	(((
	44	[[Testing we want to do>>doc:.New research.WebHome]]
	45	)))
	46
6.34	47	=== (% style="color:inherit; font-family:inherit; font-size:26px" %){{id name="Alpha"/}}(%%)Alpha ===
6.1	48
7.2	49	We asked if:
1.1	50
1.12	51	(((
7.2	52	* an open community of content people want to contribute to a single style guide
	53	* we'd like to rely on evidence for the style guide elements – and if yes, what evidence would be most useful
	54	* a wiki model is sustainable
1.2	55	)))
1.1	56
1.26	57	Read the [[final Alpha blog update>>https://contentdesign.london/research/readability-alpha-the-end/]].
1.1	58
1.2	59	Alpha ran from July to October, 2018.
1.5	60
1.1	61
6.22	62	=== {{id name="Beta"/}}Beta ===
1.1	63
6.55	64	From the Alpha discussions we identified 17 content style [[usability questions>>doc:.Usability questions.WebHome]]. We searched for evidence to answer them in Beta.
1.1	65
6.98	66	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.
6.55	67
1.26	68	Read the [[final Beta blog update>>url:https://contentdesign.london/content-process/readability-guidelines-beta-update-4-by-lizzie-bruce/]].
1.1	69
	70	Beta was October to December 2018.
1.5	71
1.1	72
6.93	73	(% class="box" %)
	74	(((
6.1	75	== {{id name="Gi"/}}Get involved ==
1.8	76
1.25	77	Explore and join us:
1.8	78
1.10	79	(((
6.19	80	* read the global Slack discussions: [[readabilityguidelines.slack.com>>url:https://readabilityguidelines.slack.com/]], join: [[bit.ly/2D0OW1F>>url:https://bit.ly/2D0OW1F]]
9.1	81	* read the Content Design London [[project blog posts>>https://contentdesign.london/usability/readability-guidelines/]]
1.11	82	* watch the London Accessibility MeetUp [[Readability Guidelines talk>>url:https://www.youtube.com/watch?v=PQzdtE8JQOs]]'
1.10	83	* share usability studies and academic research evidence on this wiki
	84	* follow #ReadabilityGuidelines on Twitter and LinkedIn
	85
	86	We have almost 500 members in our Slack community.
6.3	87
1.8	88	)))
	89
6.23	90	== Editing the wiki ==
1.1	91
12.1	92	This is a totally open project. You're welcome to comment on, edit or create wiki pages.
9.2	93	The only rules are:
1.2	94
1.16	95	* be respectful
	96	* make any comments in the spirit of positive open learning
6.101	97	* read the wiki pages carefully, and study existing evidence, before making comments and edits
	98	* include usability evidence to support any edits
1.16	99
9.1	100	=== Getting a log in ===
	101
9.2	102	You can comment on any page without logging in.
	103	But if you'd like to add usability evidence please [[request a log-in>>mailto:lizzie@contentdesign.london]]. It may take a few days for us to set up your wiki account.
6.100	104
	105	Any comments or queries outside of this wiki, please get in touch on twitter [[@ContentDesignLN>>url:https://readabilityguidelines.slack.com]].
6.93	106	)))
6.32	107
6.94	108	==
	109	Wiki sections ==
6.32	110
6.97	111	* [[Clear language>>path:/xwiki/bin/view/Plain%20English/]]
	112	* [[Grammar points>>path:/xwiki/bin/view/Punctuation%20and%20abbreviating/]]
	113	* [[Audiences>>path:/xwiki/bin/view/Audience%20descriptors/]]
6.32	114	* [[Content design>>path:/xwiki/bin/view/User%20centred%20design/]]

Wiki source code of Readability Guidelines

Navigation