SlideShare a Scribd company logo
A Technical Writer’s Trip to
Hollywood
—or—
What can we learn from Master
Classes in writing, anyway?
© Elisa Sawyer 2000-2013
ascribe@gmail.com
Opening scene of “Casablaca” sets the context of the story.
…who we (they) are…
…what we’re (they’re) doing…
…context…
…context…
WHERE I STARTED…
Grant proposal writing:
Mission, Goals, Objectives; start with the executive summary, re-
write until the last minute.
SDK documentation:
The tech-savvy love (live) to solve problems
−but−
if we don’t give them the context they need, they’re forced to solve
our problem before they get to solve theirs.
SCREENWRITING IS
TECHNICAL WRITING.
During my first screenwriting class I realized…
ADVANCED WRITING SKILLS
Metaphor, characterization, context, story,
irony, word play, relationship, learning theory,
language and culture, neuropsychology,
…and more…
THE WRITER AS PROBLEM
SOLVER
Data, metadata, patterns and prejudices…
Screenwriting 101
Identify your genre.
−this means−
Know your audience.
Screen writing is scene writing
To write a good scene:
• know why the scene is necessary.
• create a beginning, middle and end.
• make the day in which your scene takes
place, unlike any other.
• illustrate a change.
• to make the scene memorable, turn it by
adding a twist.
Scene types
Can you think of
structured authoring
topics as scenes?
Is structure
confining, or does it
free you to focus on
what’s important?
Illustrations from Dakota Powell’s course materials for “Theme and Scene,” UCLAX
Assemble Scenes into Story Arc
From: http://www.thewritersjourney.com/hero%27s_journey.htm#Memo
Vogler’s Famous Memo
Christopher Vogler, memo written in mid-1980’s while at Disney Studios
The Hero’s Journey
The “Hollywood Formula” emerged out of
“what works,” in three acts:
• Call to adventure resisted and then
answered.
• Journey into unknown to overcome
insurmountable obstacles.
• Victory and return with elixir.
Cross-cultural arcs
Identifying patterns that persist across
cultures helps to increase understanding.
Used with permission of Rosalyn L. Bruyere, from her coursework on
“Sacred Medicine Wheel”
Back to scene/story structure
As an information architect, which director
would you like to emulate?
Another look at story
• Opening image
• Theme stated
• Set-up
• Catalyst
• Debate
• Break into two
• B-story
• Fun and games
• Midpoint
• Bad guys close in
• All is lost
• Dark night of the soul
• Break into three
• Finale
• Final Image
From Blake Snyder’s “Save the Cat”
CHARACTER
Make your characters immediately knowable.
Create character arcs with satisfying endings.
Scott Myers’ Five Archetypes:
• Protagonist
• Nemesis
• Attractor
• Mentor
• Trickster
“A character archetype is an ideal example of a
fictional character who has a specific narrative
function.”
Included with permission of Scott Myers. His blog: gointothestory.com
Using Dreyfus’ model of skill acquisition
Skill Level Experience Needs
Master Creates new traditions Core concepts
Expert Intuitive grasp of many
situations
Patterns
Proficient Zeros in accurately on
important areas
Maxims
Competent Understands standard
practices
Guidance on salient
features
Advanced beginner Recognizes recurring
aspects
Rules with some
context
Beginner Little to none Context-free rules
Dreyfus, Stuart E.; Dreyfus, Hubert L. (February 1980). A Five-Stage Model of the Mental Activities Involved in Directed Skill Acquisition
Make exposition fun
Me
I think that when we do exposition really well, it becomes part
of the story itself and doesn't seem like exposition any more.
That, I think, is my take-away from this course.
Scott
Precisely. Either it's fascinating, mysterious or a revelation and
the content itself transcends exposition, or the way in which
it's conveyed via conflict, action or humor 'shrouds' the
exposition and comes across as entertaining. Thanks for
that summary. It's a keeper.
Levels of abstraction
State of being
Archetypal
Abstract symbolic
Literal symbolic
Objective reality
Bridge
• State of being—" "
• Archetypal—"As our top diplomat, he’s the
bridge between our cultures."
• Abstract symbolic—"Let’s build bridges between
our departments"
• Literal symbolic—"We’re using the conference
bridge."
• Objective reality—"I cross the Bay Bridge every
morning."
Networking Layers (levels)
This graphic courtesy of http://www.boran.com/security/it10-lan-wan.html.
Realities of technology
• Technology thrives on specialization
• Each specialty has its own language and culture
• Specialists have internalized organizing
concepts and don’t mention them. 
• Technical writers are interpreters
Risk when using specialist’s
descriptions for wider audiences:
discrete bits of information without
context makes them inaccessible
WHERE ARE WE?
A look at “Inception” and “Source Code.”
Change to resist or embrace
Chief O’Brien
It’s not a computer, it’s an adversary!
Devices as characters
From Star Trek DS 9, S1 E17
Understanding the user POV
Under the right circumstances, people enjoy
solving problems,
−but−
if we don’t give them the context they need,
they’re forced to solve someone else’s
problem before they get to the point of
solving theirs.
Interactions between the user, their
goal, the device, software and Help
Do these map to the five archetypes?
Protagonist
Nemesis
Attractor
Mentor
Trickster
Quark
I’m stuck with you!
Odo
No, I’m stuck with you, which is infinitely worse!
Whose point of view? Does it matter?
From Star Trek DS 9, S3 E7
DITA: Object Oriented
Authoring
• Topics are like scenes.
• Software architects tend to think in
metaphor, like writers.
• Stories might look linear but they are
neither linear in software nor in movies.
Lessons
• Find the stories.
• Writing is re-writing.
• Be aware of the characters.
• Don’t get distracted by the special effects.
• Sometimes our “worst” ideas are worthy.
• We write love stories for nerds.

More Related Content

Similar to A Technical Writer's Trip to Hollywood

Digital storytelling slideshow
Digital storytelling slideshowDigital storytelling slideshow
Digital storytelling slideshow
mkiefer18
 
Writing: Structure Increases Creativity
Writing: Structure Increases CreativityWriting: Structure Increases Creativity
Writing: Structure Increases CreativityJTaylor Education
 
Super powers launch
Super powers launchSuper powers launch
Super powers launch
dandtatjths
 
Scripting to win
Scripting to win Scripting to win
Scripting to win
Mutagubya Nelson
 
Terri Muharsky Resume 2010
Terri Muharsky Resume 2010Terri Muharsky Resume 2010
Terri Muharsky Resume 2010
Aracnix
 
Shutter island narrative
Shutter island   narrativeShutter island   narrative
Shutter island narrative
Naamah Hill
 
Engagement, Interaction & Narrative Design for Transmedia Storytelling
Engagement, Interaction & Narrative Design for Transmedia StorytellingEngagement, Interaction & Narrative Design for Transmedia Storytelling
Engagement, Interaction & Narrative Design for Transmedia StorytellingPeter von Stackelberg
 
Dragon Archivist Required: Evaluating The Suitability of a Role Playing Game...
Dragon Archivist Required:  Evaluating The Suitability of a Role Playing Game...Dragon Archivist Required:  Evaluating The Suitability of a Role Playing Game...
Dragon Archivist Required: Evaluating The Suitability of a Role Playing Game...
University of South Australlia
 
Video production presentation pdf
Video production presentation pdfVideo production presentation pdf
Video production presentation pdf
News Channels
 
Case study ad
Case study adCase study ad
Case study adibz10
 
Case study ad
Case study adCase study ad
Case study adibz10
 
Case study ad
Case study adCase study ad
Case study adibz10
 
Transmedia Storytelling
Transmedia StorytellingTransmedia Storytelling
Transmedia Storytelling
Siobhan O'Flynn
 
The curious incident of the dog in the night
The curious incident of the dog in the nightThe curious incident of the dog in the night
The curious incident of the dog in the nightajdk
 
Aft158 story writing_for_animation_1
Aft158 story writing_for_animation_1Aft158 story writing_for_animation_1
Aft158 story writing_for_animation_1
krishn verma
 
Creative Outlets Confratute 2015 DAY FOUR
Creative Outlets Confratute 2015 DAY FOURCreative Outlets Confratute 2015 DAY FOUR
Creative Outlets Confratute 2015 DAY FOUR
Brian Housand
 
Writing A Contrast Essay.pdf
Writing A Contrast Essay.pdfWriting A Contrast Essay.pdf
Writing A Contrast Essay.pdf
Laura Cappabianca
 
Lights, Camera, Distraction: An introduction to screenwriting
Lights, Camera, Distraction: An introduction to screenwritingLights, Camera, Distraction: An introduction to screenwriting
Lights, Camera, Distraction: An introduction to screenwriting
Gaz Johnson
 
Creating a Successful Transmedia Project
Creating a Successful Transmedia ProjectCreating a Successful Transmedia Project
Creating a Successful Transmedia Project
Robert Pratten
 

Similar to A Technical Writer's Trip to Hollywood (20)

Digital storytelling slideshow
Digital storytelling slideshowDigital storytelling slideshow
Digital storytelling slideshow
 
Writing: Structure Increases Creativity
Writing: Structure Increases CreativityWriting: Structure Increases Creativity
Writing: Structure Increases Creativity
 
Super powers launch
Super powers launchSuper powers launch
Super powers launch
 
Scripting to win
Scripting to win Scripting to win
Scripting to win
 
Terri Muharsky Resume 2010
Terri Muharsky Resume 2010Terri Muharsky Resume 2010
Terri Muharsky Resume 2010
 
Shutter island narrative
Shutter island   narrativeShutter island   narrative
Shutter island narrative
 
Engagement, Interaction & Narrative Design for Transmedia Storytelling
Engagement, Interaction & Narrative Design for Transmedia StorytellingEngagement, Interaction & Narrative Design for Transmedia Storytelling
Engagement, Interaction & Narrative Design for Transmedia Storytelling
 
Dragon Archivist Required: Evaluating The Suitability of a Role Playing Game...
Dragon Archivist Required:  Evaluating The Suitability of a Role Playing Game...Dragon Archivist Required:  Evaluating The Suitability of a Role Playing Game...
Dragon Archivist Required: Evaluating The Suitability of a Role Playing Game...
 
Video production presentation pdf
Video production presentation pdfVideo production presentation pdf
Video production presentation pdf
 
4 Crooks
4 Crooks4 Crooks
4 Crooks
 
Case study ad
Case study adCase study ad
Case study ad
 
Case study ad
Case study adCase study ad
Case study ad
 
Case study ad
Case study adCase study ad
Case study ad
 
Transmedia Storytelling
Transmedia StorytellingTransmedia Storytelling
Transmedia Storytelling
 
The curious incident of the dog in the night
The curious incident of the dog in the nightThe curious incident of the dog in the night
The curious incident of the dog in the night
 
Aft158 story writing_for_animation_1
Aft158 story writing_for_animation_1Aft158 story writing_for_animation_1
Aft158 story writing_for_animation_1
 
Creative Outlets Confratute 2015 DAY FOUR
Creative Outlets Confratute 2015 DAY FOURCreative Outlets Confratute 2015 DAY FOUR
Creative Outlets Confratute 2015 DAY FOUR
 
Writing A Contrast Essay.pdf
Writing A Contrast Essay.pdfWriting A Contrast Essay.pdf
Writing A Contrast Essay.pdf
 
Lights, Camera, Distraction: An introduction to screenwriting
Lights, Camera, Distraction: An introduction to screenwritingLights, Camera, Distraction: An introduction to screenwriting
Lights, Camera, Distraction: An introduction to screenwriting
 
Creating a Successful Transmedia Project
Creating a Successful Transmedia ProjectCreating a Successful Transmedia Project
Creating a Successful Transmedia Project
 

More from Elisa Sawyer

Getting internal Dev Doc Right
Getting internal Dev Doc RightGetting internal Dev Doc Right
Getting internal Dev Doc Right
Elisa Sawyer
 
Seeing Story Everywhere/Story craft in technical writing
Seeing Story Everywhere/Story craft in technical writingSeeing Story Everywhere/Story craft in technical writing
Seeing Story Everywhere/Story craft in technical writing
Elisa Sawyer
 
Writing The Story--or--Confronting the Grue
Writing The Story--or--Confronting the GrueWriting The Story--or--Confronting the Grue
Writing The Story--or--Confronting the Grue
Elisa Sawyer
 
A Writer's Theory of Everything
A Writer's Theory of EverythingA Writer's Theory of Everything
A Writer's Theory of Everything
Elisa Sawyer
 
SST 2014; The Reluctant SME
SST 2014; The Reluctant SMESST 2014; The Reluctant SME
SST 2014; The Reluctant SME
Elisa Sawyer
 
Stc 2014-reluctant-sme
Stc 2014-reluctant-smeStc 2014-reluctant-sme
Stc 2014-reluctant-smeElisa Sawyer
 

More from Elisa Sawyer (6)

Getting internal Dev Doc Right
Getting internal Dev Doc RightGetting internal Dev Doc Right
Getting internal Dev Doc Right
 
Seeing Story Everywhere/Story craft in technical writing
Seeing Story Everywhere/Story craft in technical writingSeeing Story Everywhere/Story craft in technical writing
Seeing Story Everywhere/Story craft in technical writing
 
Writing The Story--or--Confronting the Grue
Writing The Story--or--Confronting the GrueWriting The Story--or--Confronting the Grue
Writing The Story--or--Confronting the Grue
 
A Writer's Theory of Everything
A Writer's Theory of EverythingA Writer's Theory of Everything
A Writer's Theory of Everything
 
SST 2014; The Reluctant SME
SST 2014; The Reluctant SMESST 2014; The Reluctant SME
SST 2014; The Reluctant SME
 
Stc 2014-reluctant-sme
Stc 2014-reluctant-smeStc 2014-reluctant-sme
Stc 2014-reluctant-sme
 

Recently uploaded

Epistemic Interaction - tuning interfaces to provide information for AI support
Epistemic Interaction - tuning interfaces to provide information for AI supportEpistemic Interaction - tuning interfaces to provide information for AI support
Epistemic Interaction - tuning interfaces to provide information for AI support
Alan Dix
 
GDG Cloud Southlake #33: Boule & Rebala: Effective AppSec in SDLC using Deplo...
GDG Cloud Southlake #33: Boule & Rebala: Effective AppSec in SDLC using Deplo...GDG Cloud Southlake #33: Boule & Rebala: Effective AppSec in SDLC using Deplo...
GDG Cloud Southlake #33: Boule & Rebala: Effective AppSec in SDLC using Deplo...
James Anderson
 
FIDO Alliance Osaka Seminar: Overview.pdf
FIDO Alliance Osaka Seminar: Overview.pdfFIDO Alliance Osaka Seminar: Overview.pdf
FIDO Alliance Osaka Seminar: Overview.pdf
FIDO Alliance
 
JMeter webinar - integration with InfluxDB and Grafana
JMeter webinar - integration with InfluxDB and GrafanaJMeter webinar - integration with InfluxDB and Grafana
JMeter webinar - integration with InfluxDB and Grafana
RTTS
 
How world-class product teams are winning in the AI era by CEO and Founder, P...
How world-class product teams are winning in the AI era by CEO and Founder, P...How world-class product teams are winning in the AI era by CEO and Founder, P...
How world-class product teams are winning in the AI era by CEO and Founder, P...
Product School
 
Elevating Tactical DDD Patterns Through Object Calisthenics
Elevating Tactical DDD Patterns Through Object CalisthenicsElevating Tactical DDD Patterns Through Object Calisthenics
Elevating Tactical DDD Patterns Through Object Calisthenics
Dorra BARTAGUIZ
 
Generating a custom Ruby SDK for your web service or Rails API using Smithy
Generating a custom Ruby SDK for your web service or Rails API using SmithyGenerating a custom Ruby SDK for your web service or Rails API using Smithy
Generating a custom Ruby SDK for your web service or Rails API using Smithy
g2nightmarescribd
 
State of ICS and IoT Cyber Threat Landscape Report 2024 preview
State of ICS and IoT Cyber Threat Landscape Report 2024 previewState of ICS and IoT Cyber Threat Landscape Report 2024 preview
State of ICS and IoT Cyber Threat Landscape Report 2024 preview
Prayukth K V
 
Builder.ai Founder Sachin Dev Duggal's Strategic Approach to Create an Innova...
Builder.ai Founder Sachin Dev Duggal's Strategic Approach to Create an Innova...Builder.ai Founder Sachin Dev Duggal's Strategic Approach to Create an Innova...
Builder.ai Founder Sachin Dev Duggal's Strategic Approach to Create an Innova...
Ramesh Iyer
 
UiPath Test Automation using UiPath Test Suite series, part 4
UiPath Test Automation using UiPath Test Suite series, part 4UiPath Test Automation using UiPath Test Suite series, part 4
UiPath Test Automation using UiPath Test Suite series, part 4
DianaGray10
 
Mission to Decommission: Importance of Decommissioning Products to Increase E...
Mission to Decommission: Importance of Decommissioning Products to Increase E...Mission to Decommission: Importance of Decommissioning Products to Increase E...
Mission to Decommission: Importance of Decommissioning Products to Increase E...
Product School
 
UiPath Test Automation using UiPath Test Suite series, part 3
UiPath Test Automation using UiPath Test Suite series, part 3UiPath Test Automation using UiPath Test Suite series, part 3
UiPath Test Automation using UiPath Test Suite series, part 3
DianaGray10
 
Empowering NextGen Mobility via Large Action Model Infrastructure (LAMI): pav...
Empowering NextGen Mobility via Large Action Model Infrastructure (LAMI): pav...Empowering NextGen Mobility via Large Action Model Infrastructure (LAMI): pav...
Empowering NextGen Mobility via Large Action Model Infrastructure (LAMI): pav...
Thierry Lestable
 
Essentials of Automations: Optimizing FME Workflows with Parameters
Essentials of Automations: Optimizing FME Workflows with ParametersEssentials of Automations: Optimizing FME Workflows with Parameters
Essentials of Automations: Optimizing FME Workflows with Parameters
Safe Software
 
When stars align: studies in data quality, knowledge graphs, and machine lear...
When stars align: studies in data quality, knowledge graphs, and machine lear...When stars align: studies in data quality, knowledge graphs, and machine lear...
When stars align: studies in data quality, knowledge graphs, and machine lear...
Elena Simperl
 
Kubernetes & AI - Beauty and the Beast !?! @KCD Istanbul 2024
Kubernetes & AI - Beauty and the Beast !?! @KCD Istanbul 2024Kubernetes & AI - Beauty and the Beast !?! @KCD Istanbul 2024
Kubernetes & AI - Beauty and the Beast !?! @KCD Istanbul 2024
Tobias Schneck
 
Smart TV Buyer Insights Survey 2024 by 91mobiles.pdf
Smart TV Buyer Insights Survey 2024 by 91mobiles.pdfSmart TV Buyer Insights Survey 2024 by 91mobiles.pdf
Smart TV Buyer Insights Survey 2024 by 91mobiles.pdf
91mobiles
 
AI for Every Business: Unlocking Your Product's Universal Potential by VP of ...
AI for Every Business: Unlocking Your Product's Universal Potential by VP of ...AI for Every Business: Unlocking Your Product's Universal Potential by VP of ...
AI for Every Business: Unlocking Your Product's Universal Potential by VP of ...
Product School
 
Securing your Kubernetes cluster_ a step-by-step guide to success !
Securing your Kubernetes cluster_ a step-by-step guide to success !Securing your Kubernetes cluster_ a step-by-step guide to success !
Securing your Kubernetes cluster_ a step-by-step guide to success !
KatiaHIMEUR1
 
Key Trends Shaping the Future of Infrastructure.pdf
Key Trends Shaping the Future of Infrastructure.pdfKey Trends Shaping the Future of Infrastructure.pdf
Key Trends Shaping the Future of Infrastructure.pdf
Cheryl Hung
 

Recently uploaded (20)

Epistemic Interaction - tuning interfaces to provide information for AI support
Epistemic Interaction - tuning interfaces to provide information for AI supportEpistemic Interaction - tuning interfaces to provide information for AI support
Epistemic Interaction - tuning interfaces to provide information for AI support
 
GDG Cloud Southlake #33: Boule & Rebala: Effective AppSec in SDLC using Deplo...
GDG Cloud Southlake #33: Boule & Rebala: Effective AppSec in SDLC using Deplo...GDG Cloud Southlake #33: Boule & Rebala: Effective AppSec in SDLC using Deplo...
GDG Cloud Southlake #33: Boule & Rebala: Effective AppSec in SDLC using Deplo...
 
FIDO Alliance Osaka Seminar: Overview.pdf
FIDO Alliance Osaka Seminar: Overview.pdfFIDO Alliance Osaka Seminar: Overview.pdf
FIDO Alliance Osaka Seminar: Overview.pdf
 
JMeter webinar - integration with InfluxDB and Grafana
JMeter webinar - integration with InfluxDB and GrafanaJMeter webinar - integration with InfluxDB and Grafana
JMeter webinar - integration with InfluxDB and Grafana
 
How world-class product teams are winning in the AI era by CEO and Founder, P...
How world-class product teams are winning in the AI era by CEO and Founder, P...How world-class product teams are winning in the AI era by CEO and Founder, P...
How world-class product teams are winning in the AI era by CEO and Founder, P...
 
Elevating Tactical DDD Patterns Through Object Calisthenics
Elevating Tactical DDD Patterns Through Object CalisthenicsElevating Tactical DDD Patterns Through Object Calisthenics
Elevating Tactical DDD Patterns Through Object Calisthenics
 
Generating a custom Ruby SDK for your web service or Rails API using Smithy
Generating a custom Ruby SDK for your web service or Rails API using SmithyGenerating a custom Ruby SDK for your web service or Rails API using Smithy
Generating a custom Ruby SDK for your web service or Rails API using Smithy
 
State of ICS and IoT Cyber Threat Landscape Report 2024 preview
State of ICS and IoT Cyber Threat Landscape Report 2024 previewState of ICS and IoT Cyber Threat Landscape Report 2024 preview
State of ICS and IoT Cyber Threat Landscape Report 2024 preview
 
Builder.ai Founder Sachin Dev Duggal's Strategic Approach to Create an Innova...
Builder.ai Founder Sachin Dev Duggal's Strategic Approach to Create an Innova...Builder.ai Founder Sachin Dev Duggal's Strategic Approach to Create an Innova...
Builder.ai Founder Sachin Dev Duggal's Strategic Approach to Create an Innova...
 
UiPath Test Automation using UiPath Test Suite series, part 4
UiPath Test Automation using UiPath Test Suite series, part 4UiPath Test Automation using UiPath Test Suite series, part 4
UiPath Test Automation using UiPath Test Suite series, part 4
 
Mission to Decommission: Importance of Decommissioning Products to Increase E...
Mission to Decommission: Importance of Decommissioning Products to Increase E...Mission to Decommission: Importance of Decommissioning Products to Increase E...
Mission to Decommission: Importance of Decommissioning Products to Increase E...
 
UiPath Test Automation using UiPath Test Suite series, part 3
UiPath Test Automation using UiPath Test Suite series, part 3UiPath Test Automation using UiPath Test Suite series, part 3
UiPath Test Automation using UiPath Test Suite series, part 3
 
Empowering NextGen Mobility via Large Action Model Infrastructure (LAMI): pav...
Empowering NextGen Mobility via Large Action Model Infrastructure (LAMI): pav...Empowering NextGen Mobility via Large Action Model Infrastructure (LAMI): pav...
Empowering NextGen Mobility via Large Action Model Infrastructure (LAMI): pav...
 
Essentials of Automations: Optimizing FME Workflows with Parameters
Essentials of Automations: Optimizing FME Workflows with ParametersEssentials of Automations: Optimizing FME Workflows with Parameters
Essentials of Automations: Optimizing FME Workflows with Parameters
 
When stars align: studies in data quality, knowledge graphs, and machine lear...
When stars align: studies in data quality, knowledge graphs, and machine lear...When stars align: studies in data quality, knowledge graphs, and machine lear...
When stars align: studies in data quality, knowledge graphs, and machine lear...
 
Kubernetes & AI - Beauty and the Beast !?! @KCD Istanbul 2024
Kubernetes & AI - Beauty and the Beast !?! @KCD Istanbul 2024Kubernetes & AI - Beauty and the Beast !?! @KCD Istanbul 2024
Kubernetes & AI - Beauty and the Beast !?! @KCD Istanbul 2024
 
Smart TV Buyer Insights Survey 2024 by 91mobiles.pdf
Smart TV Buyer Insights Survey 2024 by 91mobiles.pdfSmart TV Buyer Insights Survey 2024 by 91mobiles.pdf
Smart TV Buyer Insights Survey 2024 by 91mobiles.pdf
 
AI for Every Business: Unlocking Your Product's Universal Potential by VP of ...
AI for Every Business: Unlocking Your Product's Universal Potential by VP of ...AI for Every Business: Unlocking Your Product's Universal Potential by VP of ...
AI for Every Business: Unlocking Your Product's Universal Potential by VP of ...
 
Securing your Kubernetes cluster_ a step-by-step guide to success !
Securing your Kubernetes cluster_ a step-by-step guide to success !Securing your Kubernetes cluster_ a step-by-step guide to success !
Securing your Kubernetes cluster_ a step-by-step guide to success !
 
Key Trends Shaping the Future of Infrastructure.pdf
Key Trends Shaping the Future of Infrastructure.pdfKey Trends Shaping the Future of Infrastructure.pdf
Key Trends Shaping the Future of Infrastructure.pdf
 

A Technical Writer's Trip to Hollywood

  • 1. A Technical Writer’s Trip to Hollywood —or— What can we learn from Master Classes in writing, anyway? © Elisa Sawyer 2000-2013 ascribe@gmail.com
  • 2. Opening scene of “Casablaca” sets the context of the story.
  • 3. …who we (they) are… …what we’re (they’re) doing… …context… …context…
  • 4. WHERE I STARTED… Grant proposal writing: Mission, Goals, Objectives; start with the executive summary, re- write until the last minute. SDK documentation: The tech-savvy love (live) to solve problems −but− if we don’t give them the context they need, they’re forced to solve our problem before they get to solve theirs.
  • 5. SCREENWRITING IS TECHNICAL WRITING. During my first screenwriting class I realized…
  • 6. ADVANCED WRITING SKILLS Metaphor, characterization, context, story, irony, word play, relationship, learning theory, language and culture, neuropsychology, …and more…
  • 7. THE WRITER AS PROBLEM SOLVER Data, metadata, patterns and prejudices…
  • 8. Screenwriting 101 Identify your genre. −this means− Know your audience.
  • 9. Screen writing is scene writing To write a good scene: • know why the scene is necessary. • create a beginning, middle and end. • make the day in which your scene takes place, unlike any other. • illustrate a change. • to make the scene memorable, turn it by adding a twist.
  • 10. Scene types Can you think of structured authoring topics as scenes? Is structure confining, or does it free you to focus on what’s important? Illustrations from Dakota Powell’s course materials for “Theme and Scene,” UCLAX
  • 11. Assemble Scenes into Story Arc From: http://www.thewritersjourney.com/hero%27s_journey.htm#Memo
  • 12. Vogler’s Famous Memo Christopher Vogler, memo written in mid-1980’s while at Disney Studios
  • 13. The Hero’s Journey The “Hollywood Formula” emerged out of “what works,” in three acts: • Call to adventure resisted and then answered. • Journey into unknown to overcome insurmountable obstacles. • Victory and return with elixir.
  • 14. Cross-cultural arcs Identifying patterns that persist across cultures helps to increase understanding. Used with permission of Rosalyn L. Bruyere, from her coursework on “Sacred Medicine Wheel”
  • 15. Back to scene/story structure As an information architect, which director would you like to emulate?
  • 16. Another look at story • Opening image • Theme stated • Set-up • Catalyst • Debate • Break into two • B-story • Fun and games • Midpoint • Bad guys close in • All is lost • Dark night of the soul • Break into three • Finale • Final Image From Blake Snyder’s “Save the Cat”
  • 17. CHARACTER Make your characters immediately knowable. Create character arcs with satisfying endings.
  • 18. Scott Myers’ Five Archetypes: • Protagonist • Nemesis • Attractor • Mentor • Trickster “A character archetype is an ideal example of a fictional character who has a specific narrative function.” Included with permission of Scott Myers. His blog: gointothestory.com
  • 19. Using Dreyfus’ model of skill acquisition Skill Level Experience Needs Master Creates new traditions Core concepts Expert Intuitive grasp of many situations Patterns Proficient Zeros in accurately on important areas Maxims Competent Understands standard practices Guidance on salient features Advanced beginner Recognizes recurring aspects Rules with some context Beginner Little to none Context-free rules Dreyfus, Stuart E.; Dreyfus, Hubert L. (February 1980). A Five-Stage Model of the Mental Activities Involved in Directed Skill Acquisition
  • 20. Make exposition fun Me I think that when we do exposition really well, it becomes part of the story itself and doesn't seem like exposition any more. That, I think, is my take-away from this course. Scott Precisely. Either it's fascinating, mysterious or a revelation and the content itself transcends exposition, or the way in which it's conveyed via conflict, action or humor 'shrouds' the exposition and comes across as entertaining. Thanks for that summary. It's a keeper.
  • 21. Levels of abstraction State of being Archetypal Abstract symbolic Literal symbolic Objective reality
  • 22. Bridge • State of being—" " • Archetypal—"As our top diplomat, he’s the bridge between our cultures." • Abstract symbolic—"Let’s build bridges between our departments" • Literal symbolic—"We’re using the conference bridge." • Objective reality—"I cross the Bay Bridge every morning."
  • 23. Networking Layers (levels) This graphic courtesy of http://www.boran.com/security/it10-lan-wan.html.
  • 24. Realities of technology • Technology thrives on specialization • Each specialty has its own language and culture • Specialists have internalized organizing concepts and don’t mention them.  • Technical writers are interpreters Risk when using specialist’s descriptions for wider audiences: discrete bits of information without context makes them inaccessible
  • 25. WHERE ARE WE? A look at “Inception” and “Source Code.”
  • 26. Change to resist or embrace
  • 27. Chief O’Brien It’s not a computer, it’s an adversary! Devices as characters From Star Trek DS 9, S1 E17
  • 28. Understanding the user POV Under the right circumstances, people enjoy solving problems, −but− if we don’t give them the context they need, they’re forced to solve someone else’s problem before they get to the point of solving theirs.
  • 29. Interactions between the user, their goal, the device, software and Help Do these map to the five archetypes? Protagonist Nemesis Attractor Mentor Trickster
  • 30. Quark I’m stuck with you! Odo No, I’m stuck with you, which is infinitely worse! Whose point of view? Does it matter? From Star Trek DS 9, S3 E7
  • 31. DITA: Object Oriented Authoring • Topics are like scenes. • Software architects tend to think in metaphor, like writers. • Stories might look linear but they are neither linear in software nor in movies.
  • 32. Lessons • Find the stories. • Writing is re-writing. • Be aware of the characters. • Don’t get distracted by the special effects. • Sometimes our “worst” ideas are worthy. • We write love stories for nerds.