SlideShare a Scribd company logo
Don't Be a Technical Writer, Be
an Interface Designer
1. Write Like You're Designing an Interface
2. Design Interfaces
04-Dec-2014
An interface: Something that helps you use
something to do something.
04-Dec-2014
04-Dec-2014
Interface
Companies Think
People Want To
• Learn
• Define
• Manage
• Configure
04-Dec-2014
People Want To
• Understand
• Act
• Forget
• "Point and shoot"
What makes a good interface?
What makes a good interface?
Invisible
What makes a good interface?
Invisible
Unsurprising
What makes a good interface?
Invisible
Unsurprising
Few obvious, useful actions >
many complicated actions
What makes a good interface?
Invisible
Unsurprising
Few obvious, useful actions >
many complicated actions
Doesn't ask you to learn a
language
What makes a good interface?
Invisible
Unsurprising
Few obvious, useful actions >
many complicated actions
Doesn't ask you to learn a
language
Exposes tasks, not tools
What makes a good interface?
Invisible
Unsurprising
Few obvious, useful actions >
many complicated actions
Doesn't ask you to learn a
language
Exposes tasks, not tools
Worth it
Who designs interfaces?
Who designs interfaces?
• Product Manager (Physical, UI, API, …)
• Technical Writer
• Also UX Designer, Product Designer, etc.
04-Dec-2014
Who designs interfaces?
• Product managers (and developers) design
tools, not tasks
• The "K Key" story.
R&D
TW
You should do it
• Provide more value to your company
• Be more integrated with development
• Make your company better
• Open up new, interesting career paths with
your skills
1. They think about tasks
2. They think about structure and presentation
3. They think about ambiguity
4. They think about consistency
04-Dec-2014
Why is a good TW a good interface designer?
• What does the customer want to do?
• What does the customer need to do it?
• What will the customer do next?
04-Dec-2014
1. They think about tasks
Create a Mountain Profile:
MMID:
Please enter a Mountain Profile
Handle:
• Fewer words
• Relevant concepts
• No abbreviations
04-Dec-2014
2. They think about structure and presentation
• Context where appropriate
• No passive voice
x may be created
DogBarks()
Paragraph_Capital()
04-Dec-2014
3. They think about ambiguity
• Spelling
• Case
• Terminology
• Structure
04-Dec-2014
4. They think about consistency
Documentation
Enter a name
Type an ID
Add a username
UI/API
dog(bark,name)
cat(name,sound)
tree(bark)
Buff up your skills:
• Your product’s features, from end to end
• Languages
• Trade journals / websites
• User forums
1. Write Like You're Designing an Interface
2. Design Interfaces
04-Dec-2014
Thanks
jergames.com
linkedin.com/in/jergames
@Shade_Jon
shadejon@gmail.com

More Related Content

PPTX
Preparing for an interview
PPTX
Resume work sample_careerday2018 (1)
PPTX
IMEX Recap
PDF
UX Process v0.1 - A work in progress
PPT
Inspire! Graphic design for non-designers mar 2014
KEY
Building Apps with Great Design
PPTX
20 api design tips to stop annoying developers
PDF
Usability Speech (Jens Hoffmann) - T3CON08
Preparing for an interview
Resume work sample_careerday2018 (1)
IMEX Recap
UX Process v0.1 - A work in progress
Inspire! Graphic design for non-designers mar 2014
Building Apps with Great Design
20 api design tips to stop annoying developers
Usability Speech (Jens Hoffmann) - T3CON08

Similar to Dont be a technical writer be an interface designer (20)

PDF
Characteristics of a well designed user interface
DOCX
UI vs. UX: What’s the difference?
PPT
What Is Interaction Design
PDF
Design for developers
PPTX
OOP -interface and objects.pptx
PPT
SECh1516
PPT
Human Factors and User Interface Design
PDF
Hacking UX: Product Design Thinking for Techies
PDF
Designing Interfaces 1st Edition Jenifer Tidwell
PPT
From a technical writer to a usability engineer
PPT
Workshop: What Is Use Interface
PPT
Introduction to HCI.ppt
PPT
Introduction to HCI Human Computer Interaction
PPT
chapter one Introduction to HCI.ppt
PPT
Introduction to HCI.ppt
PPT
ahsdjHDHVdjhvHDVSJADHSAVDHVNCDSHVJHVSJHCVASDHVJSAHVJSV
PPT
HCI 66.pptsgsdgdgwdgfsdfgsdfgsdfgsdgsdgsdgsdg
PDF
Tampa Bay UX - Scary UI 2
PPTX
A thing or two about User Experience
PPTX
Ch 1 Introduction to User Interaction Design Mary Margarat
Characteristics of a well designed user interface
UI vs. UX: What’s the difference?
What Is Interaction Design
Design for developers
OOP -interface and objects.pptx
SECh1516
Human Factors and User Interface Design
Hacking UX: Product Design Thinking for Techies
Designing Interfaces 1st Edition Jenifer Tidwell
From a technical writer to a usability engineer
Workshop: What Is Use Interface
Introduction to HCI.ppt
Introduction to HCI Human Computer Interaction
chapter one Introduction to HCI.ppt
Introduction to HCI.ppt
ahsdjHDHVdjhvHDVSJADHSAVDHVNCDSHVJHVSJHCVASDHVJSAHVJSV
HCI 66.pptsgsdgdgwdgfsdfgsdfgsdfgsdgsdgsdgsdg
Tampa Bay UX - Scary UI 2
A thing or two about User Experience
Ch 1 Introduction to User Interaction Design Mary Margarat
Ad

Recently uploaded (20)

PDF
ENT215_Completing-a-large-scale-migration-and-modernization-with-AWS.pdf
PDF
CloudStack 4.21: First Look Webinar slides
PDF
DP Operators-handbook-extract for the Mautical Institute
PPTX
O2C Customer Invoices to Receipt V15A.pptx
PDF
Zenith AI: Advanced Artificial Intelligence
PPTX
Final SEM Unit 1 for mit wpu at pune .pptx
PDF
Architecture types and enterprise applications.pdf
PPT
What is a Computer? Input Devices /output devices
PDF
August Patch Tuesday
PDF
A contest of sentiment analysis: k-nearest neighbor versus neural network
PDF
WOOl fibre morphology and structure.pdf for textiles
PDF
Video forgery: An extensive analysis of inter-and intra-frame manipulation al...
PDF
Getting Started with Data Integration: FME Form 101
PPT
Geologic Time for studying geology for geologist
PDF
Univ-Connecticut-ChatGPT-Presentaion.pdf
PPTX
Tartificialntelligence_presentation.pptx
PPTX
observCloud-Native Containerability and monitoring.pptx
PPT
Module 1.ppt Iot fundamentals and Architecture
PDF
NewMind AI Weekly Chronicles – August ’25 Week III
PPTX
Modernising the Digital Integration Hub
ENT215_Completing-a-large-scale-migration-and-modernization-with-AWS.pdf
CloudStack 4.21: First Look Webinar slides
DP Operators-handbook-extract for the Mautical Institute
O2C Customer Invoices to Receipt V15A.pptx
Zenith AI: Advanced Artificial Intelligence
Final SEM Unit 1 for mit wpu at pune .pptx
Architecture types and enterprise applications.pdf
What is a Computer? Input Devices /output devices
August Patch Tuesday
A contest of sentiment analysis: k-nearest neighbor versus neural network
WOOl fibre morphology and structure.pdf for textiles
Video forgery: An extensive analysis of inter-and intra-frame manipulation al...
Getting Started with Data Integration: FME Form 101
Geologic Time for studying geology for geologist
Univ-Connecticut-ChatGPT-Presentaion.pdf
Tartificialntelligence_presentation.pptx
observCloud-Native Containerability and monitoring.pptx
Module 1.ppt Iot fundamentals and Architecture
NewMind AI Weekly Chronicles – August ’25 Week III
Modernising the Digital Integration Hub
Ad

Dont be a technical writer be an interface designer

  • 1. Don't Be a Technical Writer, Be an Interface Designer
  • 2. 1. Write Like You're Designing an Interface 2. Design Interfaces 04-Dec-2014
  • 3. An interface: Something that helps you use something to do something. 04-Dec-2014
  • 5. Companies Think People Want To • Learn • Define • Manage • Configure 04-Dec-2014 People Want To • Understand • Act • Forget • "Point and shoot"
  • 6. What makes a good interface?
  • 7. What makes a good interface? Invisible
  • 8. What makes a good interface? Invisible Unsurprising
  • 9. What makes a good interface? Invisible Unsurprising Few obvious, useful actions > many complicated actions
  • 10. What makes a good interface? Invisible Unsurprising Few obvious, useful actions > many complicated actions Doesn't ask you to learn a language
  • 11. What makes a good interface? Invisible Unsurprising Few obvious, useful actions > many complicated actions Doesn't ask you to learn a language Exposes tasks, not tools
  • 12. What makes a good interface? Invisible Unsurprising Few obvious, useful actions > many complicated actions Doesn't ask you to learn a language Exposes tasks, not tools Worth it
  • 14. Who designs interfaces? • Product Manager (Physical, UI, API, …) • Technical Writer • Also UX Designer, Product Designer, etc. 04-Dec-2014
  • 15. Who designs interfaces? • Product managers (and developers) design tools, not tasks • The "K Key" story.
  • 17. You should do it • Provide more value to your company • Be more integrated with development • Make your company better • Open up new, interesting career paths with your skills
  • 18. 1. They think about tasks 2. They think about structure and presentation 3. They think about ambiguity 4. They think about consistency 04-Dec-2014 Why is a good TW a good interface designer?
  • 19. • What does the customer want to do? • What does the customer need to do it? • What will the customer do next? 04-Dec-2014 1. They think about tasks Create a Mountain Profile: MMID: Please enter a Mountain Profile Handle:
  • 20. • Fewer words • Relevant concepts • No abbreviations 04-Dec-2014 2. They think about structure and presentation
  • 21. • Context where appropriate • No passive voice x may be created DogBarks() Paragraph_Capital() 04-Dec-2014 3. They think about ambiguity
  • 22. • Spelling • Case • Terminology • Structure 04-Dec-2014 4. They think about consistency Documentation Enter a name Type an ID Add a username UI/API dog(bark,name) cat(name,sound) tree(bark)
  • 23. Buff up your skills: • Your product’s features, from end to end • Languages • Trade journals / websites • User forums
  • 24. 1. Write Like You're Designing an Interface 2. Design Interfaces 04-Dec-2014

Editor's Notes

  • #2: Airplane joke