SlideShare a Scribd company logo
1 of 51
From Practitioner to
Published Author

{

A Workshop About
Writing About Software
Beth Romanik
&
Jonathan Vanian

Software Quality Engineering
TechWell.com
StickyMinds.com
AgileConnection.com
CMCrossroads.com
Better Software magazine
Getting to know you…
Name?
Where are you from?
What do you do?
What is your experience or
interest in writing?
Why are you here today?
Types of writers
• Authors
• Bloggers
• Copywriters
• Content writers
• Curators
• Interviewers
Making contact with
a publication
1. Read the publication.
• Do you like the subject matter?
• Is it somewhere you’d want to be
published?
2. Research submission
guidelines.
• Contact the right person
• Make sure you can deliver what and
when they’re asking for
3. Make contact.
• Be polite
• Give some of your qualifications and
interests
• No boilerplate
• Keep it to just a few sentences
• Link to other work you’ve had
published, if applicable
Some tips for
writing well
“Let’s say that he should go out and
hang himself because he finds that
writing well is impossibly difficult.
Then he should be cut down
without mercy and forced by his
own self to write as well as he can
for the rest of his life. At least he
will have the story of the hanging to
commence with.”
—Ernest Hemingway
1. Find a subject you care about
and are knowledgeable about.
• Commit to only one
2. Learn about your target
publication.
•
•
•
•

Tone
Person
Word count
Technical level
3. Take inspiration from what
you like to read.
•
•
•
•
•

Style
Words
Examples
Quotations
References
4. Discover what organizational
method works for you.
•
•
•
•
•
•

Notes
Outline
Burst of inspiration
Music
Walk away
Sit and commit
5. Have the courage to write
badly.
• Fear gives you writer’s block
• The first sentence is just something to
build on
• Get through the first draft
• Revisit, revise, rewrite
6. Start with a bang.
• Grab your reader
• Set up what’s to come
• Look for inspiration
7. Avoid clichés like the plague.
•
•
•
•

Definitions
Google search results
Most people…
Just like me
8. Choose your words wisely.
•
•
•
•
•

Generic
Pretentious
Wordiness
Sensationalism
Alphabet soup
9. Short is sweet.
•
•
•
•

Break up run-on sentences
3 to 5 sentences per paragraph
Optimized for screens
White space is less intimidating
10. End with a decisive last
sentence.
•
•
•
•

Summary
Looking ahead
Quotation
Call to action
Some tips for
editing well
1. Come back to it.
•
•
•
•
•

Reread immediately
Clear your head
Sleep on it
Any questions?
Try to be objective
2. Read it out loud.
• Make sure it sounds natural
• Revise for length
3. Employ another set of eyes.
•
•
•
•

Someone whose opinion you value
Preferably another writer
Someone in your field
Take criticism/suggestions seriously
Some tips on
writing headlines
1. Use action words.
• More verbs and adverbs, fewer nouns
and adjectives
Compare:

• Twitter soars 73% in stock market debut
• Twitter IPO shares up 73% by end of day
2. Use numbers.
• Lists
• Numerals, not words
• Place at beginning of headline
Instead of: “Maximize your time with
these five tips”
Write: “5 tips to maximize your time”
3. Teach the people.
• “An introduction to”
• “How to”
• “The beginner’s guide to”
4. But don’t be pushy.

This analysis was based on a sample of over 100,000 paid links that ran in
Outbrain’s network between April and November 2012.
5. Be a Negative Nancy.
• Use “no,” “not,” “without,” “stop”
Instead of: “This app will make your
life easier”
Write: “The app you can’t live without”
6. Add some power words.
•
•
•
•
•
•
•

Smart
Surprising
Science
History
Hacks (hacking, hackers, etc.)
Huge/ big
Critical

Iris Shoor and her company Takipi analyzed the top 100 blogs to see which
words in headlines made a post get more shares
7. Consider SEO.
• Be specific
• Include terms people will search for
Instead of: “Get better at organizing
your day”
Write: “A guide to organizing your day
and increasing focus”
Write: “10 smart tips to organize your
day and make you more productive”
Some tips on
getting published
1. Check submission guidelines.
• Whom to send to
• What format
• Timeline
2. Be patient.
• Remember that timeline
• Be persistent, but not annoying
3. Develop a thick skin.
•
•
•
•

It’s not personal
Be willing to accept changes
Ask questions
If at first you don’t succeed…
Time for some
writing exercises!
Exercise 1: Story topics
Write a short paragraph
that sums up an original
story idea. This should
establish what the rest of
your story will be about.
Example 1:
Using the recent problems plaguing the
Healthcare.gov site as a case study, this story will
show readers the importance of an organization being
able to support a healthy project culture in order to
mitigate these types of project disasters.
Example 2:
While we all know that agile software development
has grown enormously over the past several years,
many companies still find themselves practicing
waterfall development. This story will detail the
obstacles preventing an organization from adopting
agile and the problems organizations have when
confronting change.
Exercise 2: Writing
headlines
Read the beginnings of
the following two stories
and write three headlines
designed to get the most
clicks.
An analysis of Steve Jobs’ career revealed that his
rather unceremonious exit from his first tenure at
Apple made him learn new skills that were needed to
run a large corporation. One of the skills was
improving the ability to work with a diverse set of
people, which is broadly an attribute of good
teamwork. Of the many sources available to learn
about teamwork, sports-related metaphors are often
the best.

The Tour de France is one of the most arduous cycling
events in the world. Being strong, aggressive, and
strategic are often mentioned as key skills needed to
master this event. But in addition to these skills,
teamwork is usually the key factor that separates the
winners from the losers.
The black swan theory is a metaphor used to
describe an event that comes as a surprise and has
major consequences. Black swans have been
receiving attention lately because of the
Healthcare.gov technical woes, but the health care
rollout isn’t the first software project to be
characterized as a black swan.
In the Computerworld article about the project’s
problems, it defines black swan as an event that is
difficult to predict and is disruptive. But given the
long history of flawed and failed projects and plenty
written on lessons learned, why should any
software disaster come as such a surprise that it’s
called a black swan event?
Time to share!
•
•
•
•
•

Experiences
Successes
Frustrations
Questions
Your own advice
One final thought:
Practice, practice, practice.
Beth Romanik
bromanik@sqe.com
Jonathan Vanian
jvanian@sqe.com

Thank you!

More Related Content

What's hot

'If you can't be kind, be scholarly': constructive peer reviewing (LILAC 2016)
'If you can't be kind, be scholarly': constructive peer reviewing (LILAC 2016)'If you can't be kind, be scholarly': constructive peer reviewing (LILAC 2016)
'If you can't be kind, be scholarly': constructive peer reviewing (LILAC 2016)Emma Coonan
 
Publication without tears (LILAC 2016)
Publication without tears (LILAC 2016)Publication without tears (LILAC 2016)
Publication without tears (LILAC 2016)Emma Coonan
 
User Interview Techniques
User Interview TechniquesUser Interview Techniques
User Interview TechniquesLiz Danzico
 
Advance tips of Content Marketing
Advance tips of Content MarketingAdvance tips of Content Marketing
Advance tips of Content MarketingNezam Uddin Rakib
 
MBO Partners Webinar: Building Effective Client Presentations
MBO Partners Webinar: Building Effective Client PresentationsMBO Partners Webinar: Building Effective Client Presentations
MBO Partners Webinar: Building Effective Client PresentationsMBO Partners
 
Step4
Step4Step4
Step4xerx
 
How to Make a Good Research Argument
How to Make a Good Research ArgumentHow to Make a Good Research Argument
How to Make a Good Research ArgumentGrace Hui Yang
 
Refresher Content Writers
Refresher   Content WritersRefresher   Content Writers
Refresher Content WritersRon Carandang
 
How to Get My Paper Accepted at Top Software Engineering Conferences
How to Get My Paper Accepted at Top Software Engineering ConferencesHow to Get My Paper Accepted at Top Software Engineering Conferences
How to Get My Paper Accepted at Top Software Engineering ConferencesAlex Orso
 
Ethics - or how to have good manners in your scientific career
Ethics - or how to have good manners in your scientific careerEthics - or how to have good manners in your scientific career
Ethics - or how to have good manners in your scientific careerJoshua Knowles
 
Facilitating online conversations
Facilitating online conversationsFacilitating online conversations
Facilitating online conversationsSara Shapiro-Plevan
 
20090720 writing a_paper
20090720 writing a_paper20090720 writing a_paper
20090720 writing a_paperMichael Karpov
 
Tips presentation final
Tips presentation finalTips presentation final
Tips presentation finalksre
 
Writing for Funding
Writing for FundingWriting for Funding
Writing for Fundingunmgrc
 
8 Steps To Writing A Great Paper
8  Steps To  Writing A  Great  Paper8  Steps To  Writing A  Great  Paper
8 Steps To Writing A Great Paperc9602374
 

What's hot (20)

'If you can't be kind, be scholarly': constructive peer reviewing (LILAC 2016)
'If you can't be kind, be scholarly': constructive peer reviewing (LILAC 2016)'If you can't be kind, be scholarly': constructive peer reviewing (LILAC 2016)
'If you can't be kind, be scholarly': constructive peer reviewing (LILAC 2016)
 
Publication without tears (LILAC 2016)
Publication without tears (LILAC 2016)Publication without tears (LILAC 2016)
Publication without tears (LILAC 2016)
 
User Interview Techniques
User Interview TechniquesUser Interview Techniques
User Interview Techniques
 
Advance tips of Content Marketing
Advance tips of Content MarketingAdvance tips of Content Marketing
Advance tips of Content Marketing
 
If you can't be kind, be scholarly. Constructive peer reviewing - Emma Coonan
If you can't be kind, be scholarly. Constructive peer reviewing - Emma CoonanIf you can't be kind, be scholarly. Constructive peer reviewing - Emma Coonan
If you can't be kind, be scholarly. Constructive peer reviewing - Emma Coonan
 
MBO Partners Webinar: Building Effective Client Presentations
MBO Partners Webinar: Building Effective Client PresentationsMBO Partners Webinar: Building Effective Client Presentations
MBO Partners Webinar: Building Effective Client Presentations
 
Publication without tears: Tips for aspiring authors - Emma Coonan
Publication without tears: Tips for aspiring authors - Emma CoonanPublication without tears: Tips for aspiring authors - Emma Coonan
Publication without tears: Tips for aspiring authors - Emma Coonan
 
Step4
Step4Step4
Step4
 
How to Make a Good Research Argument
How to Make a Good Research ArgumentHow to Make a Good Research Argument
How to Make a Good Research Argument
 
Refresher Content Writers
Refresher   Content WritersRefresher   Content Writers
Refresher Content Writers
 
Great blog headline webinar svc
Great blog headline webinar svcGreat blog headline webinar svc
Great blog headline webinar svc
 
How to Get My Paper Accepted at Top Software Engineering Conferences
How to Get My Paper Accepted at Top Software Engineering ConferencesHow to Get My Paper Accepted at Top Software Engineering Conferences
How to Get My Paper Accepted at Top Software Engineering Conferences
 
How I write
How I writeHow I write
How I write
 
Ethics - or how to have good manners in your scientific career
Ethics - or how to have good manners in your scientific careerEthics - or how to have good manners in your scientific career
Ethics - or how to have good manners in your scientific career
 
Facilitating online conversations
Facilitating online conversationsFacilitating online conversations
Facilitating online conversations
 
20090720 writing a_paper
20090720 writing a_paper20090720 writing a_paper
20090720 writing a_paper
 
Tips presentation final
Tips presentation finalTips presentation final
Tips presentation final
 
Writing for Funding
Writing for FundingWriting for Funding
Writing for Funding
 
Creative writting-techniques
Creative writting-techniquesCreative writting-techniques
Creative writting-techniques
 
8 Steps To Writing A Great Paper
8  Steps To  Writing A  Great  Paper8  Steps To  Writing A  Great  Paper
8 Steps To Writing A Great Paper
 

Viewers also liked

Using Business Objectives to Design Better Products
Using Business Objectives to Design Better ProductsUsing Business Objectives to Design Better Products
Using Business Objectives to Design Better ProductsTechWell
 
Validating Assumptions: From Unknown to Known
Validating Assumptions: From Unknown to KnownValidating Assumptions: From Unknown to Known
Validating Assumptions: From Unknown to KnownTechWell
 
Acceptance Test-Driven Development: Mastering Agile Testing
Acceptance Test-Driven Development: Mastering Agile TestingAcceptance Test-Driven Development: Mastering Agile Testing
Acceptance Test-Driven Development: Mastering Agile TestingTechWell
 
Rapid Performance Testing: No Load Generation Required
Rapid Performance Testing: No Load Generation RequiredRapid Performance Testing: No Load Generation Required
Rapid Performance Testing: No Load Generation RequiredTechWell
 
Configuration Management Best Practices
Configuration Management Best PracticesConfiguration Management Best Practices
Configuration Management Best PracticesTechWell
 
Games Software People Play: Reasoning, Tactics, Biases, Fallacies
Games Software People Play: Reasoning, Tactics, Biases, FallaciesGames Software People Play: Reasoning, Tactics, Biases, Fallacies
Games Software People Play: Reasoning, Tactics, Biases, FallaciesTechWell
 
Mobile Test Automation with Big Data Analytics
Mobile Test Automation with Big Data AnalyticsMobile Test Automation with Big Data Analytics
Mobile Test Automation with Big Data AnalyticsTechWell
 
A Year of “Testing” the Cloud for Development and Test
A Year of “Testing” the Cloud for Development and TestA Year of “Testing” the Cloud for Development and Test
A Year of “Testing” the Cloud for Development and TestTechWell
 
Eight Steps to Kanban
Eight Steps to KanbanEight Steps to Kanban
Eight Steps to KanbanTechWell
 
Model-Based Testing with Keywords
Model-Based Testing with KeywordsModel-Based Testing with Keywords
Model-Based Testing with KeywordsTechWell
 
Patterns for Collaboration: Toward Whole-Team Quality
Patterns for Collaboration: Toward Whole-Team QualityPatterns for Collaboration: Toward Whole-Team Quality
Patterns for Collaboration: Toward Whole-Team QualityTechWell
 
Essential Patterns of Mature Agile Teams
Essential Patterns of Mature Agile TeamsEssential Patterns of Mature Agile Teams
Essential Patterns of Mature Agile TeamsTechWell
 
Measure Customer and Business Feedback to Drive Improvement
Measure Customer and Business Feedback to Drive ImprovementMeasure Customer and Business Feedback to Drive Improvement
Measure Customer and Business Feedback to Drive ImprovementTechWell
 
Dealing with Estimation, Uncertainty, Risk, and Commitment
Dealing with Estimation, Uncertainty, Risk, and CommitmentDealing with Estimation, Uncertainty, Risk, and Commitment
Dealing with Estimation, Uncertainty, Risk, and CommitmentTechWell
 
Continuous Delivery: Rapid and Reliable Releases with DevOps Practices
Continuous Delivery: Rapid and Reliable Releases with DevOps PracticesContinuous Delivery: Rapid and Reliable Releases with DevOps Practices
Continuous Delivery: Rapid and Reliable Releases with DevOps PracticesTechWell
 

Viewers also liked (15)

Using Business Objectives to Design Better Products
Using Business Objectives to Design Better ProductsUsing Business Objectives to Design Better Products
Using Business Objectives to Design Better Products
 
Validating Assumptions: From Unknown to Known
Validating Assumptions: From Unknown to KnownValidating Assumptions: From Unknown to Known
Validating Assumptions: From Unknown to Known
 
Acceptance Test-Driven Development: Mastering Agile Testing
Acceptance Test-Driven Development: Mastering Agile TestingAcceptance Test-Driven Development: Mastering Agile Testing
Acceptance Test-Driven Development: Mastering Agile Testing
 
Rapid Performance Testing: No Load Generation Required
Rapid Performance Testing: No Load Generation RequiredRapid Performance Testing: No Load Generation Required
Rapid Performance Testing: No Load Generation Required
 
Configuration Management Best Practices
Configuration Management Best PracticesConfiguration Management Best Practices
Configuration Management Best Practices
 
Games Software People Play: Reasoning, Tactics, Biases, Fallacies
Games Software People Play: Reasoning, Tactics, Biases, FallaciesGames Software People Play: Reasoning, Tactics, Biases, Fallacies
Games Software People Play: Reasoning, Tactics, Biases, Fallacies
 
Mobile Test Automation with Big Data Analytics
Mobile Test Automation with Big Data AnalyticsMobile Test Automation with Big Data Analytics
Mobile Test Automation with Big Data Analytics
 
A Year of “Testing” the Cloud for Development and Test
A Year of “Testing” the Cloud for Development and TestA Year of “Testing” the Cloud for Development and Test
A Year of “Testing” the Cloud for Development and Test
 
Eight Steps to Kanban
Eight Steps to KanbanEight Steps to Kanban
Eight Steps to Kanban
 
Model-Based Testing with Keywords
Model-Based Testing with KeywordsModel-Based Testing with Keywords
Model-Based Testing with Keywords
 
Patterns for Collaboration: Toward Whole-Team Quality
Patterns for Collaboration: Toward Whole-Team QualityPatterns for Collaboration: Toward Whole-Team Quality
Patterns for Collaboration: Toward Whole-Team Quality
 
Essential Patterns of Mature Agile Teams
Essential Patterns of Mature Agile TeamsEssential Patterns of Mature Agile Teams
Essential Patterns of Mature Agile Teams
 
Measure Customer and Business Feedback to Drive Improvement
Measure Customer and Business Feedback to Drive ImprovementMeasure Customer and Business Feedback to Drive Improvement
Measure Customer and Business Feedback to Drive Improvement
 
Dealing with Estimation, Uncertainty, Risk, and Commitment
Dealing with Estimation, Uncertainty, Risk, and CommitmentDealing with Estimation, Uncertainty, Risk, and Commitment
Dealing with Estimation, Uncertainty, Risk, and Commitment
 
Continuous Delivery: Rapid and Reliable Releases with DevOps Practices
Continuous Delivery: Rapid and Reliable Releases with DevOps PracticesContinuous Delivery: Rapid and Reliable Releases with DevOps Practices
Continuous Delivery: Rapid and Reliable Releases with DevOps Practices
 

Similar to Writing workshop adcbsc east13

How to Prepare for and Survive a Technical Interview
How to Prepare for and Survive a Technical InterviewHow to Prepare for and Survive a Technical Interview
How to Prepare for and Survive a Technical InterviewPerl Careers
 
How to be a Better YOU online!
How to be a Better YOU online!How to be a Better YOU online!
How to be a Better YOU online!Sajeetharan
 
Writing style for business that's so good people will ask for seconds with a ...
Writing style for business that's so good people will ask for seconds with a ...Writing style for business that's so good people will ask for seconds with a ...
Writing style for business that's so good people will ask for seconds with a ...Jamie Teator
 
Preparing/Making your Blog Site
Preparing/Making your Blog SitePreparing/Making your Blog Site
Preparing/Making your Blog SiteAzmain Rahman
 
2014 NACAC 2014: Make Your Stories Pop: Strategies to Help Students Share The...
2014 NACAC 2014: Make Your Stories Pop: Strategies to Help Students Share The...2014 NACAC 2014: Make Your Stories Pop: Strategies to Help Students Share The...
2014 NACAC 2014: Make Your Stories Pop: Strategies to Help Students Share The...Rebecca Joseph
 
Writing and Producing in the Online space - There is no better time than no...
  Writing and Producing in the Online space - There is no better time than no...  Writing and Producing in the Online space - There is no better time than no...
Writing and Producing in the Online space - There is no better time than no...Mila Araujo
 
8 Seconds_Writing for Digital Communications.12.11
8 Seconds_Writing for Digital Communications.12.118 Seconds_Writing for Digital Communications.12.11
8 Seconds_Writing for Digital Communications.12.11Carolyn Hudson
 
9 best blog writing templates
9 best blog writing templates 9 best blog writing templates
9 best blog writing templates Gerome Soriano
 
Ringling College of Art & Design: Content and Social Media
Ringling College of Art & Design: Content and Social MediaRingling College of Art & Design: Content and Social Media
Ringling College of Art & Design: Content and Social MediaAutumn Sullivan
 
Prof lili saghafi How to Write Research Plan / Dissertation Project and Thesis
Prof lili saghafi  How to Write Research Plan / Dissertation Project and Thesis Prof lili saghafi  How to Write Research Plan / Dissertation Project and Thesis
Prof lili saghafi How to Write Research Plan / Dissertation Project and Thesis Professor Lili Saghafi
 
Best Tips on How to Get Master of Science in Criminology
Best Tips on How to Get Master of Science in CriminologyBest Tips on How to Get Master of Science in Criminology
Best Tips on How to Get Master of Science in CriminologyCrimi Application
 
Writing for the Web
Writing for the WebWriting for the Web
Writing for the WebPhil Buckley
 
Article Writing Tips
Article Writing TipsArticle Writing Tips
Article Writing TipsMd Ekram
 
Technical Authorship in Practice
Technical Authorship in PracticeTechnical Authorship in Practice
Technical Authorship in PracticePetri Kainulainen
 
NO Video Shiefgab Phoenix Presentation
NO Video Shiefgab Phoenix PresentationNO Video Shiefgab Phoenix Presentation
NO Video Shiefgab Phoenix PresentationJeffrey S. Forth
 
Contextualized Online Search and Research Skills.pptx
Contextualized Online Search and Research Skills.pptxContextualized Online Search and Research Skills.pptx
Contextualized Online Search and Research Skills.pptxJhayRom
 

Similar to Writing workshop adcbsc east13 (20)

How to Prepare for and Survive a Technical Interview
How to Prepare for and Survive a Technical InterviewHow to Prepare for and Survive a Technical Interview
How to Prepare for and Survive a Technical Interview
 
How to be a Better YOU online!
How to be a Better YOU online!How to be a Better YOU online!
How to be a Better YOU online!
 
Writing style for business that's so good people will ask for seconds with a ...
Writing style for business that's so good people will ask for seconds with a ...Writing style for business that's so good people will ask for seconds with a ...
Writing style for business that's so good people will ask for seconds with a ...
 
Preparing/Making your Blog Site
Preparing/Making your Blog SitePreparing/Making your Blog Site
Preparing/Making your Blog Site
 
2014 NACAC 2014: Make Your Stories Pop: Strategies to Help Students Share The...
2014 NACAC 2014: Make Your Stories Pop: Strategies to Help Students Share The...2014 NACAC 2014: Make Your Stories Pop: Strategies to Help Students Share The...
2014 NACAC 2014: Make Your Stories Pop: Strategies to Help Students Share The...
 
Writing and Producing in the Online space - There is no better time than no...
  Writing and Producing in the Online space - There is no better time than no...  Writing and Producing in the Online space - There is no better time than no...
Writing and Producing in the Online space - There is no better time than no...
 
8 Seconds_Writing for Digital Communications.12.11
8 Seconds_Writing for Digital Communications.12.118 Seconds_Writing for Digital Communications.12.11
8 Seconds_Writing for Digital Communications.12.11
 
9 best blog writing templates
9 best blog writing templates 9 best blog writing templates
9 best blog writing templates
 
Ringling College of Art & Design: Content and Social Media
Ringling College of Art & Design: Content and Social MediaRingling College of Art & Design: Content and Social Media
Ringling College of Art & Design: Content and Social Media
 
Blogging for business
Blogging for businessBlogging for business
Blogging for business
 
e-PR lecture 3: blogging
e-PR lecture 3: blogginge-PR lecture 3: blogging
e-PR lecture 3: blogging
 
Blogging: What I've Learned
Blogging: What I've LearnedBlogging: What I've Learned
Blogging: What I've Learned
 
Prof lili saghafi How to Write Research Plan / Dissertation Project and Thesis
Prof lili saghafi  How to Write Research Plan / Dissertation Project and Thesis Prof lili saghafi  How to Write Research Plan / Dissertation Project and Thesis
Prof lili saghafi How to Write Research Plan / Dissertation Project and Thesis
 
Best Tips on How to Get Master of Science in Criminology
Best Tips on How to Get Master of Science in CriminologyBest Tips on How to Get Master of Science in Criminology
Best Tips on How to Get Master of Science in Criminology
 
Writing for the Web
Writing for the WebWriting for the Web
Writing for the Web
 
Article Writing Tips
Article Writing TipsArticle Writing Tips
Article Writing Tips
 
Technical Authorship in Practice
Technical Authorship in PracticeTechnical Authorship in Practice
Technical Authorship in Practice
 
NO Video Shiefgab Phoenix Presentation
NO Video Shiefgab Phoenix PresentationNO Video Shiefgab Phoenix Presentation
NO Video Shiefgab Phoenix Presentation
 
Funding
FundingFunding
Funding
 
Contextualized Online Search and Research Skills.pptx
Contextualized Online Search and Research Skills.pptxContextualized Online Search and Research Skills.pptx
Contextualized Online Search and Research Skills.pptx
 

More from TechWell

Failing and Recovering
Failing and RecoveringFailing and Recovering
Failing and RecoveringTechWell
 
Instill a DevOps Testing Culture in Your Team and Organization
Instill a DevOps Testing Culture in Your Team and Organization Instill a DevOps Testing Culture in Your Team and Organization
Instill a DevOps Testing Culture in Your Team and Organization TechWell
 
Test Design for Fully Automated Build Architecture
Test Design for Fully Automated Build ArchitectureTest Design for Fully Automated Build Architecture
Test Design for Fully Automated Build ArchitectureTechWell
 
System-Level Test Automation: Ensuring a Good Start
System-Level Test Automation: Ensuring a Good StartSystem-Level Test Automation: Ensuring a Good Start
System-Level Test Automation: Ensuring a Good StartTechWell
 
Build Your Mobile App Quality and Test Strategy
Build Your Mobile App Quality and Test StrategyBuild Your Mobile App Quality and Test Strategy
Build Your Mobile App Quality and Test StrategyTechWell
 
Testing Transformation: The Art and Science for Success
Testing Transformation: The Art and Science for SuccessTesting Transformation: The Art and Science for Success
Testing Transformation: The Art and Science for SuccessTechWell
 
Implement BDD with Cucumber and SpecFlow
Implement BDD with Cucumber and SpecFlowImplement BDD with Cucumber and SpecFlow
Implement BDD with Cucumber and SpecFlowTechWell
 
Develop WebDriver Automated Tests—and Keep Your Sanity
Develop WebDriver Automated Tests—and Keep Your SanityDevelop WebDriver Automated Tests—and Keep Your Sanity
Develop WebDriver Automated Tests—and Keep Your SanityTechWell
 
Eliminate Cloud Waste with a Holistic DevOps Strategy
Eliminate Cloud Waste with a Holistic DevOps StrategyEliminate Cloud Waste with a Holistic DevOps Strategy
Eliminate Cloud Waste with a Holistic DevOps StrategyTechWell
 
Transform Test Organizations for the New World of DevOps
Transform Test Organizations for the New World of DevOpsTransform Test Organizations for the New World of DevOps
Transform Test Organizations for the New World of DevOpsTechWell
 
The Fourth Constraint in Project Delivery—Leadership
The Fourth Constraint in Project Delivery—LeadershipThe Fourth Constraint in Project Delivery—Leadership
The Fourth Constraint in Project Delivery—LeadershipTechWell
 
Resolve the Contradiction of Specialists within Agile Teams
Resolve the Contradiction of Specialists within Agile TeamsResolve the Contradiction of Specialists within Agile Teams
Resolve the Contradiction of Specialists within Agile TeamsTechWell
 
Pin the Tail on the Metric: A Field-Tested Agile Game
Pin the Tail on the Metric: A Field-Tested Agile GamePin the Tail on the Metric: A Field-Tested Agile Game
Pin the Tail on the Metric: A Field-Tested Agile GameTechWell
 
Agile Performance Holarchy (APH)—A Model for Scaling Agile Teams
Agile Performance Holarchy (APH)—A Model for Scaling Agile TeamsAgile Performance Holarchy (APH)—A Model for Scaling Agile Teams
Agile Performance Holarchy (APH)—A Model for Scaling Agile TeamsTechWell
 
A Business-First Approach to DevOps Implementation
A Business-First Approach to DevOps ImplementationA Business-First Approach to DevOps Implementation
A Business-First Approach to DevOps ImplementationTechWell
 
Databases in a Continuous Integration/Delivery Process
Databases in a Continuous Integration/Delivery ProcessDatabases in a Continuous Integration/Delivery Process
Databases in a Continuous Integration/Delivery ProcessTechWell
 
Mobile Testing: What—and What Not—to Automate
Mobile Testing: What—and What Not—to AutomateMobile Testing: What—and What Not—to Automate
Mobile Testing: What—and What Not—to AutomateTechWell
 
Cultural Intelligence: A Key Skill for Success
Cultural Intelligence: A Key Skill for SuccessCultural Intelligence: A Key Skill for Success
Cultural Intelligence: A Key Skill for SuccessTechWell
 
Turn the Lights On: A Power Utility Company's Agile Transformation
Turn the Lights On: A Power Utility Company's Agile TransformationTurn the Lights On: A Power Utility Company's Agile Transformation
Turn the Lights On: A Power Utility Company's Agile TransformationTechWell
 

More from TechWell (20)

Failing and Recovering
Failing and RecoveringFailing and Recovering
Failing and Recovering
 
Instill a DevOps Testing Culture in Your Team and Organization
Instill a DevOps Testing Culture in Your Team and Organization Instill a DevOps Testing Culture in Your Team and Organization
Instill a DevOps Testing Culture in Your Team and Organization
 
Test Design for Fully Automated Build Architecture
Test Design for Fully Automated Build ArchitectureTest Design for Fully Automated Build Architecture
Test Design for Fully Automated Build Architecture
 
System-Level Test Automation: Ensuring a Good Start
System-Level Test Automation: Ensuring a Good StartSystem-Level Test Automation: Ensuring a Good Start
System-Level Test Automation: Ensuring a Good Start
 
Build Your Mobile App Quality and Test Strategy
Build Your Mobile App Quality and Test StrategyBuild Your Mobile App Quality and Test Strategy
Build Your Mobile App Quality and Test Strategy
 
Testing Transformation: The Art and Science for Success
Testing Transformation: The Art and Science for SuccessTesting Transformation: The Art and Science for Success
Testing Transformation: The Art and Science for Success
 
Implement BDD with Cucumber and SpecFlow
Implement BDD with Cucumber and SpecFlowImplement BDD with Cucumber and SpecFlow
Implement BDD with Cucumber and SpecFlow
 
Develop WebDriver Automated Tests—and Keep Your Sanity
Develop WebDriver Automated Tests—and Keep Your SanityDevelop WebDriver Automated Tests—and Keep Your Sanity
Develop WebDriver Automated Tests—and Keep Your Sanity
 
Ma 15
Ma 15Ma 15
Ma 15
 
Eliminate Cloud Waste with a Holistic DevOps Strategy
Eliminate Cloud Waste with a Holistic DevOps StrategyEliminate Cloud Waste with a Holistic DevOps Strategy
Eliminate Cloud Waste with a Holistic DevOps Strategy
 
Transform Test Organizations for the New World of DevOps
Transform Test Organizations for the New World of DevOpsTransform Test Organizations for the New World of DevOps
Transform Test Organizations for the New World of DevOps
 
The Fourth Constraint in Project Delivery—Leadership
The Fourth Constraint in Project Delivery—LeadershipThe Fourth Constraint in Project Delivery—Leadership
The Fourth Constraint in Project Delivery—Leadership
 
Resolve the Contradiction of Specialists within Agile Teams
Resolve the Contradiction of Specialists within Agile TeamsResolve the Contradiction of Specialists within Agile Teams
Resolve the Contradiction of Specialists within Agile Teams
 
Pin the Tail on the Metric: A Field-Tested Agile Game
Pin the Tail on the Metric: A Field-Tested Agile GamePin the Tail on the Metric: A Field-Tested Agile Game
Pin the Tail on the Metric: A Field-Tested Agile Game
 
Agile Performance Holarchy (APH)—A Model for Scaling Agile Teams
Agile Performance Holarchy (APH)—A Model for Scaling Agile TeamsAgile Performance Holarchy (APH)—A Model for Scaling Agile Teams
Agile Performance Holarchy (APH)—A Model for Scaling Agile Teams
 
A Business-First Approach to DevOps Implementation
A Business-First Approach to DevOps ImplementationA Business-First Approach to DevOps Implementation
A Business-First Approach to DevOps Implementation
 
Databases in a Continuous Integration/Delivery Process
Databases in a Continuous Integration/Delivery ProcessDatabases in a Continuous Integration/Delivery Process
Databases in a Continuous Integration/Delivery Process
 
Mobile Testing: What—and What Not—to Automate
Mobile Testing: What—and What Not—to AutomateMobile Testing: What—and What Not—to Automate
Mobile Testing: What—and What Not—to Automate
 
Cultural Intelligence: A Key Skill for Success
Cultural Intelligence: A Key Skill for SuccessCultural Intelligence: A Key Skill for Success
Cultural Intelligence: A Key Skill for Success
 
Turn the Lights On: A Power Utility Company's Agile Transformation
Turn the Lights On: A Power Utility Company's Agile TransformationTurn the Lights On: A Power Utility Company's Agile Transformation
Turn the Lights On: A Power Utility Company's Agile Transformation
 

Recently uploaded

Introduction to Nonprofit Accounting: The Basics
Introduction to Nonprofit Accounting: The BasicsIntroduction to Nonprofit Accounting: The Basics
Introduction to Nonprofit Accounting: The BasicsTechSoup
 
social pharmacy d-pharm 1st year by Pragati K. Mahajan
social pharmacy d-pharm 1st year by Pragati K. Mahajansocial pharmacy d-pharm 1st year by Pragati K. Mahajan
social pharmacy d-pharm 1st year by Pragati K. Mahajanpragatimahajan3
 
Advanced Views - Calendar View in Odoo 17
Advanced Views - Calendar View in Odoo 17Advanced Views - Calendar View in Odoo 17
Advanced Views - Calendar View in Odoo 17Celine George
 
APM Welcome, APM North West Network Conference, Synergies Across Sectors
APM Welcome, APM North West Network Conference, Synergies Across SectorsAPM Welcome, APM North West Network Conference, Synergies Across Sectors
APM Welcome, APM North West Network Conference, Synergies Across SectorsAssociation for Project Management
 
fourth grading exam for kindergarten in writing
fourth grading exam for kindergarten in writingfourth grading exam for kindergarten in writing
fourth grading exam for kindergarten in writingTeacherCyreneCayanan
 
Interactive Powerpoint_How to Master effective communication
Interactive Powerpoint_How to Master effective communicationInteractive Powerpoint_How to Master effective communication
Interactive Powerpoint_How to Master effective communicationnomboosow
 
Class 11th Physics NEET formula sheet pdf
Class 11th Physics NEET formula sheet pdfClass 11th Physics NEET formula sheet pdf
Class 11th Physics NEET formula sheet pdfAyushMahapatra5
 
Software Engineering Methodologies (overview)
Software Engineering Methodologies (overview)Software Engineering Methodologies (overview)
Software Engineering Methodologies (overview)eniolaolutunde
 
1029 - Danh muc Sach Giao Khoa 10 . pdf
1029 -  Danh muc Sach Giao Khoa 10 . pdf1029 -  Danh muc Sach Giao Khoa 10 . pdf
1029 - Danh muc Sach Giao Khoa 10 . pdfQucHHunhnh
 
Z Score,T Score, Percential Rank and Box Plot Graph
Z Score,T Score, Percential Rank and Box Plot GraphZ Score,T Score, Percential Rank and Box Plot Graph
Z Score,T Score, Percential Rank and Box Plot GraphThiyagu K
 
IGNOU MSCCFT and PGDCFT Exam Question Pattern: MCFT003 Counselling and Family...
IGNOU MSCCFT and PGDCFT Exam Question Pattern: MCFT003 Counselling and Family...IGNOU MSCCFT and PGDCFT Exam Question Pattern: MCFT003 Counselling and Family...
IGNOU MSCCFT and PGDCFT Exam Question Pattern: MCFT003 Counselling and Family...PsychoTech Services
 
microwave assisted reaction. General introduction
microwave assisted reaction. General introductionmicrowave assisted reaction. General introduction
microwave assisted reaction. General introductionMaksud Ahmed
 
Presentation by Andreas Schleicher Tackling the School Absenteeism Crisis 30 ...
Presentation by Andreas Schleicher Tackling the School Absenteeism Crisis 30 ...Presentation by Andreas Schleicher Tackling the School Absenteeism Crisis 30 ...
Presentation by Andreas Schleicher Tackling the School Absenteeism Crisis 30 ...EduSkills OECD
 
Disha NEET Physics Guide for classes 11 and 12.pdf
Disha NEET Physics Guide for classes 11 and 12.pdfDisha NEET Physics Guide for classes 11 and 12.pdf
Disha NEET Physics Guide for classes 11 and 12.pdfchloefrazer622
 
Activity 01 - Artificial Culture (1).pdf
Activity 01 - Artificial Culture (1).pdfActivity 01 - Artificial Culture (1).pdf
Activity 01 - Artificial Culture (1).pdfciinovamais
 
Q4-W6-Restating Informational Text Grade 3
Q4-W6-Restating Informational Text Grade 3Q4-W6-Restating Informational Text Grade 3
Q4-W6-Restating Informational Text Grade 3JemimahLaneBuaron
 
The basics of sentences session 2pptx copy.pptx
The basics of sentences session 2pptx copy.pptxThe basics of sentences session 2pptx copy.pptx
The basics of sentences session 2pptx copy.pptxheathfieldcps1
 
Paris 2024 Olympic Geographies - an activity
Paris 2024 Olympic Geographies - an activityParis 2024 Olympic Geographies - an activity
Paris 2024 Olympic Geographies - an activityGeoBlogs
 
Sports & Fitness Value Added Course FY..
Sports & Fitness Value Added Course FY..Sports & Fitness Value Added Course FY..
Sports & Fitness Value Added Course FY..Disha Kariya
 

Recently uploaded (20)

Introduction to Nonprofit Accounting: The Basics
Introduction to Nonprofit Accounting: The BasicsIntroduction to Nonprofit Accounting: The Basics
Introduction to Nonprofit Accounting: The Basics
 
social pharmacy d-pharm 1st year by Pragati K. Mahajan
social pharmacy d-pharm 1st year by Pragati K. Mahajansocial pharmacy d-pharm 1st year by Pragati K. Mahajan
social pharmacy d-pharm 1st year by Pragati K. Mahajan
 
Advanced Views - Calendar View in Odoo 17
Advanced Views - Calendar View in Odoo 17Advanced Views - Calendar View in Odoo 17
Advanced Views - Calendar View in Odoo 17
 
APM Welcome, APM North West Network Conference, Synergies Across Sectors
APM Welcome, APM North West Network Conference, Synergies Across SectorsAPM Welcome, APM North West Network Conference, Synergies Across Sectors
APM Welcome, APM North West Network Conference, Synergies Across Sectors
 
Código Creativo y Arte de Software | Unidad 1
Código Creativo y Arte de Software | Unidad 1Código Creativo y Arte de Software | Unidad 1
Código Creativo y Arte de Software | Unidad 1
 
fourth grading exam for kindergarten in writing
fourth grading exam for kindergarten in writingfourth grading exam for kindergarten in writing
fourth grading exam for kindergarten in writing
 
Interactive Powerpoint_How to Master effective communication
Interactive Powerpoint_How to Master effective communicationInteractive Powerpoint_How to Master effective communication
Interactive Powerpoint_How to Master effective communication
 
Class 11th Physics NEET formula sheet pdf
Class 11th Physics NEET formula sheet pdfClass 11th Physics NEET formula sheet pdf
Class 11th Physics NEET formula sheet pdf
 
Software Engineering Methodologies (overview)
Software Engineering Methodologies (overview)Software Engineering Methodologies (overview)
Software Engineering Methodologies (overview)
 
1029 - Danh muc Sach Giao Khoa 10 . pdf
1029 -  Danh muc Sach Giao Khoa 10 . pdf1029 -  Danh muc Sach Giao Khoa 10 . pdf
1029 - Danh muc Sach Giao Khoa 10 . pdf
 
Z Score,T Score, Percential Rank and Box Plot Graph
Z Score,T Score, Percential Rank and Box Plot GraphZ Score,T Score, Percential Rank and Box Plot Graph
Z Score,T Score, Percential Rank and Box Plot Graph
 
IGNOU MSCCFT and PGDCFT Exam Question Pattern: MCFT003 Counselling and Family...
IGNOU MSCCFT and PGDCFT Exam Question Pattern: MCFT003 Counselling and Family...IGNOU MSCCFT and PGDCFT Exam Question Pattern: MCFT003 Counselling and Family...
IGNOU MSCCFT and PGDCFT Exam Question Pattern: MCFT003 Counselling and Family...
 
microwave assisted reaction. General introduction
microwave assisted reaction. General introductionmicrowave assisted reaction. General introduction
microwave assisted reaction. General introduction
 
Presentation by Andreas Schleicher Tackling the School Absenteeism Crisis 30 ...
Presentation by Andreas Schleicher Tackling the School Absenteeism Crisis 30 ...Presentation by Andreas Schleicher Tackling the School Absenteeism Crisis 30 ...
Presentation by Andreas Schleicher Tackling the School Absenteeism Crisis 30 ...
 
Disha NEET Physics Guide for classes 11 and 12.pdf
Disha NEET Physics Guide for classes 11 and 12.pdfDisha NEET Physics Guide for classes 11 and 12.pdf
Disha NEET Physics Guide for classes 11 and 12.pdf
 
Activity 01 - Artificial Culture (1).pdf
Activity 01 - Artificial Culture (1).pdfActivity 01 - Artificial Culture (1).pdf
Activity 01 - Artificial Culture (1).pdf
 
Q4-W6-Restating Informational Text Grade 3
Q4-W6-Restating Informational Text Grade 3Q4-W6-Restating Informational Text Grade 3
Q4-W6-Restating Informational Text Grade 3
 
The basics of sentences session 2pptx copy.pptx
The basics of sentences session 2pptx copy.pptxThe basics of sentences session 2pptx copy.pptx
The basics of sentences session 2pptx copy.pptx
 
Paris 2024 Olympic Geographies - an activity
Paris 2024 Olympic Geographies - an activityParis 2024 Olympic Geographies - an activity
Paris 2024 Olympic Geographies - an activity
 
Sports & Fitness Value Added Course FY..
Sports & Fitness Value Added Course FY..Sports & Fitness Value Added Course FY..
Sports & Fitness Value Added Course FY..
 

Writing workshop adcbsc east13

  • 1. From Practitioner to Published Author { A Workshop About Writing About Software
  • 8. Getting to know you… Name? Where are you from? What do you do? What is your experience or interest in writing? Why are you here today?
  • 10. • Authors • Bloggers • Copywriters • Content writers • Curators • Interviewers
  • 11. Making contact with a publication
  • 12. 1. Read the publication. • Do you like the subject matter? • Is it somewhere you’d want to be published?
  • 13. 2. Research submission guidelines. • Contact the right person • Make sure you can deliver what and when they’re asking for
  • 14. 3. Make contact. • Be polite • Give some of your qualifications and interests • No boilerplate • Keep it to just a few sentences • Link to other work you’ve had published, if applicable
  • 16. “Let’s say that he should go out and hang himself because he finds that writing well is impossibly difficult. Then he should be cut down without mercy and forced by his own self to write as well as he can for the rest of his life. At least he will have the story of the hanging to commence with.” —Ernest Hemingway
  • 17. 1. Find a subject you care about and are knowledgeable about. • Commit to only one
  • 18. 2. Learn about your target publication. • • • • Tone Person Word count Technical level
  • 19. 3. Take inspiration from what you like to read. • • • • • Style Words Examples Quotations References
  • 20. 4. Discover what organizational method works for you. • • • • • • Notes Outline Burst of inspiration Music Walk away Sit and commit
  • 21. 5. Have the courage to write badly. • Fear gives you writer’s block • The first sentence is just something to build on • Get through the first draft • Revisit, revise, rewrite
  • 22. 6. Start with a bang. • Grab your reader • Set up what’s to come • Look for inspiration
  • 23. 7. Avoid clichés like the plague. • • • • Definitions Google search results Most people… Just like me
  • 24. 8. Choose your words wisely. • • • • • Generic Pretentious Wordiness Sensationalism Alphabet soup
  • 25. 9. Short is sweet. • • • • Break up run-on sentences 3 to 5 sentences per paragraph Optimized for screens White space is less intimidating
  • 26. 10. End with a decisive last sentence. • • • • Summary Looking ahead Quotation Call to action
  • 28. 1. Come back to it. • • • • • Reread immediately Clear your head Sleep on it Any questions? Try to be objective
  • 29. 2. Read it out loud. • Make sure it sounds natural • Revise for length
  • 30. 3. Employ another set of eyes. • • • • Someone whose opinion you value Preferably another writer Someone in your field Take criticism/suggestions seriously
  • 31. Some tips on writing headlines
  • 32.
  • 33. 1. Use action words. • More verbs and adverbs, fewer nouns and adjectives Compare: • Twitter soars 73% in stock market debut • Twitter IPO shares up 73% by end of day
  • 34. 2. Use numbers. • Lists • Numerals, not words • Place at beginning of headline Instead of: “Maximize your time with these five tips” Write: “5 tips to maximize your time”
  • 35. 3. Teach the people. • “An introduction to” • “How to” • “The beginner’s guide to”
  • 36. 4. But don’t be pushy. This analysis was based on a sample of over 100,000 paid links that ran in Outbrain’s network between April and November 2012.
  • 37. 5. Be a Negative Nancy. • Use “no,” “not,” “without,” “stop” Instead of: “This app will make your life easier” Write: “The app you can’t live without”
  • 38. 6. Add some power words. • • • • • • • Smart Surprising Science History Hacks (hacking, hackers, etc.) Huge/ big Critical Iris Shoor and her company Takipi analyzed the top 100 blogs to see which words in headlines made a post get more shares
  • 39. 7. Consider SEO. • Be specific • Include terms people will search for Instead of: “Get better at organizing your day” Write: “A guide to organizing your day and increasing focus” Write: “10 smart tips to organize your day and make you more productive”
  • 40. Some tips on getting published
  • 41. 1. Check submission guidelines. • Whom to send to • What format • Timeline
  • 42. 2. Be patient. • Remember that timeline • Be persistent, but not annoying
  • 43. 3. Develop a thick skin. • • • • It’s not personal Be willing to accept changes Ask questions If at first you don’t succeed…
  • 44. Time for some writing exercises!
  • 45. Exercise 1: Story topics Write a short paragraph that sums up an original story idea. This should establish what the rest of your story will be about.
  • 46. Example 1: Using the recent problems plaguing the Healthcare.gov site as a case study, this story will show readers the importance of an organization being able to support a healthy project culture in order to mitigate these types of project disasters. Example 2: While we all know that agile software development has grown enormously over the past several years, many companies still find themselves practicing waterfall development. This story will detail the obstacles preventing an organization from adopting agile and the problems organizations have when confronting change.
  • 47. Exercise 2: Writing headlines Read the beginnings of the following two stories and write three headlines designed to get the most clicks.
  • 48. An analysis of Steve Jobs’ career revealed that his rather unceremonious exit from his first tenure at Apple made him learn new skills that were needed to run a large corporation. One of the skills was improving the ability to work with a diverse set of people, which is broadly an attribute of good teamwork. Of the many sources available to learn about teamwork, sports-related metaphors are often the best. The Tour de France is one of the most arduous cycling events in the world. Being strong, aggressive, and strategic are often mentioned as key skills needed to master this event. But in addition to these skills, teamwork is usually the key factor that separates the winners from the losers.
  • 49. The black swan theory is a metaphor used to describe an event that comes as a surprise and has major consequences. Black swans have been receiving attention lately because of the Healthcare.gov technical woes, but the health care rollout isn’t the first software project to be characterized as a black swan. In the Computerworld article about the project’s problems, it defines black swan as an event that is difficult to predict and is disruptive. But given the long history of flawed and failed projects and plenty written on lessons learned, why should any software disaster come as such a surprise that it’s called a black swan event?
  • 51. One final thought: Practice, practice, practice. Beth Romanik bromanik@sqe.com Jonathan Vanian jvanian@sqe.com Thank you!

Editor's Notes

  1. Based in Northeast Florida
  2. “If you’re anything like me, then you love ice cream.” “Do you love ice cream? Well, you’re not alone.”
  3. Pretentious: Subsequently, errors manifested themselves = errors appeared afterwardWordiness: At the present time = now
  4. Poynter Institute did eye-tracking study: short paragraphs receive twice as much attention as longer ones
  5. Wait to elaborate
  6. Also: “Dealing with the death of Google Reader.” “This 3-year-old puts Adele to shame.”
  7. 10! Smart!