Workshop — How to be clear: the elements of content design

A presentation at Workshop: How to Be Clear—Writing for Apps and Software in October 2019 in Dublin, Ireland by Jonathon Colman

Slide 1

Slide 1

Writing for Apps and Software

Slide 2

Slide 2

Jonathon Colman

Slide 3

Slide 3

twitter.com/jcolman linkedin.com/in/jcolman

Slide 4

Slide 4

How to be clear

Slide 5

Slide 5

How to be clear The elements of content design

Slide 6

Slide 6

Our agenda for today 10:30–11:55am Intro & core values 11:55-12:00pm Short break 12:00–1:30pm Discovering your voice 1:30-2:30pm Lunch on your own 2:30-3:15pm Exploring tones 3:15-4:15pm Designing content 4:15-4:30pm Conclusion and Q&A

Slide 7

Slide 7

Everyone have one of these?

Slide 8

Slide 8

What you should know straightaway • Bio breaks and toilets • Be gentle, stay curious, assume best intent • This is a judgment-free zone • Please take distractions elsewhere • Introverting is a-okay • Don’t worry about finishing everything • Oh, so you’re already an expert?

Slide 9

Slide 9

Irish Writers Centre code of conduct irishwriterscentre.ie/pages/booking-conditions-cancellation-policy “…You are required to conduct yourself in an appropriate manner during all dealings and correspondence with the Irish Writers Centre. If you behave in a manner which, in the opinion of the Irish Writers Centre, is threatening, abusive, offensive or otherwise unacceptable, the Irish Writers Centre will have the right to bar you from using the website and refuse future dealings with you. You will remain liable to pay the price for products you have purchased and no refunds will be given. This statements conditions includes but are not limited to the product section of our website for both workshop and class content.”

Slide 10

Slide 10

Irish Writers Centre code of conduct irishwriterscentre.ie/pages/booking-conditions-cancellation-policy “…You are required to conduct yourself in an appropriate manner during all dealings and correspondence with the Irish Writers Centre. If you behave in a manner which, in the opinion of the Irish Writers Centre, is threatening, abusive, offensive or otherwise unacceptable, the Irish Writers Centre will have the right to bar you from using the website and refuse future dealings with you. You will remain liable to pay the price for products you have purchased and no refunds will be given. This statements conditions includes but are not limited to the product section of our website for both workshop and class content.”

Slide 11

Slide 11

Irish Writers Centre code of conduct irishwriterscentre.ie/pages/booking-conditions-cancellation-policy “…You are required to conduct yourself in an appropriate manner during all dealings and correspondence with the Irish Writers Centre. If you behave in a manner which, in the opinion of the Irish Writers Centre, is threatening, abusive, offensive or otherwise unacceptable, the Irish Writers Centre will have the right to bar you from using the website and refuse future dealings with you. You will remain liable to pay the price for products you have purchased and no refunds will be given. This statements conditions includes but are not limited to the product section of our website for both workshop and class content.”

Slide 12

Slide 12

© Charles Strebor https://www.flickr.com/photos/rantz/6688216699 (CC BY-NC-SA 2.0 — https://creativecommons.org/licenses/by-nc-sa/2.0/)

Slide 13

Slide 13

How to be clear What do we mean by clear, anyway?

Slide 14

Slide 14

How to be clear Clarity could mean: • A lack of ambiguity • Total comprehensiveness • Ease of understanding or use • Sense-making • Consistency

Slide 15

Slide 15

How to be clear Clarity could mean: • A lack of ambiguity • Total comprehensiveness • Ease of understanding or use • Sense-making • Consistency • Structure and strategy

Slide 16

Slide 16

Jesse James Garrett’s 5 planes of UX © Jesse James Garret, The Elements of User Experience - http://www.jjg.net/elements/ (used with permission)

Slide 17

Slide 17

Where content is seen and used © Jesse James Garret, The Elements of User Experience - http://www.jjg.net/elements/ (used with permission)

Slide 18

Slide 18

Where content is modeled and built © Jesse James Garret, The Elements of User Experience - http://www.jjg.net/elements/ (used with permission)

Slide 19

Slide 19

Where content is proposed and planned © Jesse James Garret, The Elements of User Experience - http://www.jjg.net/elements/ (used with permission)

Slide 20

Slide 20

Where you’ll be practicing content design today © Jesse James Garret, The Elements of User Experience - http://www.jjg.net/elements/ (used with permission)

Slide 21

Slide 21

Content design What do we mean by content design, anyway?

Slide 22

Slide 22

Content design “ Working from people’s intent and organizational goals to solve problems and create value by planning, structuring, writing, and designing content in interactive product experiences. ”

Slide 23

Slide 23

Content design “ Working from people’s intent and organizational goals to solve problems and create value by planning, structuring, writing, and designing content in interactive product experiences. ”

Slide 24

Slide 24

Content design “ Working from people’s intent and organizational goals to solve problems and create value by planning, structuring, writing, and designing content in interactive product experiences. ”

Slide 25

Slide 25

Content design “ Working from people’s intent and organizational goals to solve problems and create value by planning, structuring, writing, and designing content in interactive product experiences. ”

Slide 26

Slide 26

Content design “ Working from people’s intent and organizational goals to solve problems and create value by planning, structuring, writing, and designing content in interactive product experiences. ”

Slide 27

Slide 27

Content design “ Working from people’s intent and organizational goals to solve problems and create value by planning, structuring, writing, and designing content in interactive product experiences. ”

Slide 28

Slide 28

Content design “ Working from people’s intent and organizational goals to solve problems and create value by planning, structuring, writing, and improving content in interactive product experiences. ”

Slide 29

Slide 29

Content design Okay, then what do we mean by content?

Slide 30

Slide 30

Content design “ Content is the stuff I came here for. ”

Slide 31

Slide 31

© REI - http://www.rei.com/

Slide 32

Slide 32

© Facebook - facebook.com/crisisresponse/

Slide 33

Slide 33

© Intercom - http://www.intercom.com/

Slide 34

Slide 34

© Aer Lingus - https://www.aerlingus.com/support/contact-us/#/tab-0-ireland

Slide 35

Slide 35

© Aer Lingus - https://www.aerlingus.com/support/contact-us/#/tab-0-ireland

Slide 36

Slide 36

LANGUAGE IS AN INTERFACE © Aer Lingus - https://www.aerlingus.com/support/contact-us/#/tab-0-ireland

Slide 37

Slide 37

LANGUAGE IS INFRASTRUCTURE © Aer Lingus - https://www.aerlingus.com/support/contact-us/#/tab-0-ireland

Slide 38

Slide 38

LANGUAGE IS DESIGN MATERIAL © Aer Lingus - https://www.aerlingus.com/support/contact-us/#/tab-0-ireland

Slide 39

Slide 39

Infrastructure for clarity Core Values

Slide 40

Slide 40

Infrastructure for clarity Voice Core Values

Slide 41

Slide 41

Infrastructure for clarity Tones of voice Voice Core Values

Slide 42

Slide 42

Infrastructure for clarity Words Tones of voice Voice Core Values

Slide 43

Slide 43

A strategy for results Words Tones of voice Voice Core Values } • Standards & styles • Controlled vocabulary • Flexibility for growth • Repeatable success • Ongoing improvement

Slide 44

Slide 44

A strategy for results Words Tones of voice Voice Core Values } • Standards & styles • Controlled vocabulary • Flexibility for growth • Repeatable success • Ongoing improvement These are the elements of content design

Slide 45

Slide 45

What we won’t cover today [an incomplete list] • Content strategy for the web • Defining specific terms and usage • Information architecture • Content modeling • Localization • Product or feature naming • Visual or interaction design

Slide 46

Slide 46

What we will cover today [also an incomplete list] • Discovering your core values • Defining an organization’s voice • Documenting tones of voice • Designing product content for an app

Slide 47

Slide 47

Conclusion

Slide 48

Slide 48

Additional resources • Content + UX resources http://bit.ly/Content-UX-Resources • Content design: planning, writing, and managing content https://www.gov.uk/guidance/content-design/what-is-content-design • Voice, tone, and content guides http://voiceandtoneguides.webflow.io/ • Content strategists group on Facebook https://www.facebook.com/groups/contentstrategists/ • Content + UX Slack http://mjmetts.com/content-ux-slack/

Slide 49

Slide 49

Some books about content design • Content Strategy for the Web by Kristina Halvorson • Strategic UX Writing by Torrey Podmajersky • Nicely Said by Kate Kiefer Lee and Nicole Fenton • Content Design by Sarah Richards • The Craft of Words (Part 1 & 2) by The Standardistas

Slide 50

Slide 50

Some events featuring content design • Confab http://confabevents.com/ • Information Architecture Summit http://iasummit.org/ • Euro IA https://euroia.org/ • Meetups https://www.meetup.com/

Slide 51

Slide 51

meetup.com/Dublin-Content-Design-Strategy-Meetup/

Slide 52

Slide 52

Any final questions?

Slide 53

Slide 53

THANK YOU

Slide 54

Slide 54

THANK YOU

Slide 55

Slide 55

THANK YOU

Slide 56

Slide 56

THANK YOU

Slide 57

Slide 57

THANK YOU

Slide 58

Slide 58

THANK YOU

Slide 59

Slide 59

THANK YOU