write the docs 2014, eu

24
1 Wednesday, 2 April 14

Upload: christine-burwinkle

Post on 16-Apr-2017

848 views

Category:

Technology


0 download

TRANSCRIPT

Page 1: Write the Docs 2014, EU

1Wednesday, 2 April 14

Page 2: Write the Docs 2014, EU

Pairing with Designers to create a seamless

user experience

2Wednesday, 2 April 14

Page 3: Write the Docs 2014, EU

Intro

3Wednesday, 2 April 14

Page 4: Write the Docs 2014, EU

• Atlassian has a very strong Design team• Traditionally, tech writing has played a very traditional

role

• There was opportunity to work together, as these teams have the same basic goals

Some background

4Wednesday, 2 April 14

Page 5: Write the Docs 2014, EU

Bringing UX to docs

5Wednesday, 2 April 14

Page 6: Write the Docs 2014, EU

Atlassian design principles

• A few of our design principles: • Be familiar

• Grow with me

• Give me clarity

6Wednesday, 2 April 14

Page 8: Write the Docs 2014, EU

• What role is a feature targeting?

• What is assumed skills/background, etc.

• How do we best reach a certain type of user?

• What are their preferences? Their fears?

Audience/Persona

8Wednesday, 2 April 14

Page 9: Write the Docs 2014, EU

Data and measures

9Wednesday, 2 April 14

Page 10: Write the Docs 2014, EU

• Realization! Designers have access to lots of customer information!• Customer interviews & site visits

• Usability tests

• Usage information on existing features

• Long-term roadmap

Leveraging siloed data

10Wednesday, 2 April 14

Page 11: Write the Docs 2014, EU

• Piggybacking usability testing• Do we need documentation?

• If so, what are the FAQs?

• Piggybacking analytics results

Measuring success

11Wednesday, 2 April 14

Page 12: Write the Docs 2014, EU

Borrowing design techniques

12Wednesday, 2 April 14

Page 13: Write the Docs 2014, EU

• Empathy maps help bring focus on the user

• Use them to workshop how a user might feel in a “before and after” situation

• Work backward from the “after” situation

Workshopping: Empathy maps

13Wednesday, 2 April 14

Page 14: Write the Docs 2014, EU

• Great for moving ideas around

• Great for separate -> collaborative brainstorming

• Cheap, mobile, fun

Invest in Post-its

14Wednesday, 2 April 14

Page 15: Write the Docs 2014, EU

• Basically a critique session• Brings group thinking into design

and planning• A check that the goals have been

met with the prototype

Workshopping: Sparring sessions

Goals of sparring sessions:

To assure design quality by critiquing design early and often

To drive towards outcomes/decisions quickly

To keep each other in the loop and learn from each others approaches and products

15Wednesday, 2 April 14

Page 16: Write the Docs 2014, EU

• Prior, a TW sends out: • The draft to discuss• A list that covers the

goals of the document

Sparring with TWs

16Wednesday, 2 April 14

Page 17: Write the Docs 2014, EU

• Timebox, timebox, timebox!• If your team is given to negativity, try a positives-only 5

minutes• Try to make sure everyone is heard - using a checklist

or give everyone 1 minute to list feedback• Leave with at least 3 action items

Tips for running a sparring session

17Wednesday, 2 April 14

Page 18: Write the Docs 2014, EU

• 6-ups drive focus on ideal solutions

• Get you out of “word-thinking” • Good way to build on each

others’ ideas

Workshopping: 6-ups

18Wednesday, 2 April 14

Page 19: Write the Docs 2014, EU

• How does a user get to a feature? • Controlled process?

• From many different areas with different goals?

• What does a user do before? • What does a user usually do

next?

Workshopping: User stories

19Wednesday, 2 April 14

Page 20: Write the Docs 2014, EU

• Use colored stickers to “vote”

• Build out your doco plan based on the problem areas

Taking user stories to the next level

20Wednesday, 2 April 14

Page 21: Write the Docs 2014, EU

How we made this happen

21Wednesday, 2 April 14

Page 22: Write the Docs 2014, EU

• Look for a team that finds value in Design and Tech Writing

• Look for a Designer who sees the value in docs

• Look for a new project that’s running lean and has some momentum

• Look for projects that are data-driven

Find the right projects

22Wednesday, 2 April 14

Page 23: Write the Docs 2014, EU

• Check out some design principles

• Read about design techniques• Follow some UX blogs• Write a documentation

experience plan

Explore & expand

23Wednesday, 2 April 14

Page 24: Write the Docs 2014, EU

[email protected]• Christine Burwinkle on LinkedIn

Contact me

24Wednesday, 2 April 14