狠狠撸

狠狠撸Share a Scribd company logo
ed marsh
stc interchange
april 24, 2020
? 26-year technical writer
? content strategist @ major financial firm
? stc associate fellow 2020(!)
? content content podcast – edmarsh.com/podcast
? lavacon podcast - lavacon.org
? stc “speaking of techcomm” podcast co-host
? contentcontent.info
? @edmarsh
This is the moment
we’ve been waiting for!
you are more than “just a writer”
Technical
communicator
Librarian
Translator
Detective
technical communication is a
customer service role
? helping people do their job
? accommodating new and existing content
? quickly responding to user requests and updates
help your technical
support teams
? are there recurring topics that can be addressed?
? share best practices/war stories
? create connections
? break down silos!
what’s in it for me
why does it matter?
how does it help me?
how much of my (physical and mental) bandwidth
does this take?
what are the benefits to my team/company/?
what are the costs/risks?
how many resources does this require?
how many resources does this alleviate?
governance is not a dirty word
retain knowledge
Timeless TechComm Tips - STC New England Interchange Keynote 2020
? find out how your users write and
think
? are you speaking the same language as your users?
? are you considering misspellings/typos?
? are there additional keywords you can add?
? generate new topics
robohelp and madcap both have
analytics products
Timeless TechComm Tips - STC New England Interchange Keynote 2020
git (version control) doesn't work
well with pdfs
pdfs are evil on mobile
just because a spec requires pdf, it
doesn’t mean that your users want it
let go of the words
(sorry, ginny redish)
the number of words you write is not a measure of
success (MoS) or Objectives and Key Results (OKRs)
?delivery and engagement are
management (and the bottom line) doesn’t care if
you use two spaces after a period, or if you use
‘displays’ or ‘appears’
Timeless TechComm Tips - STC New England Interchange Keynote 2020
Timeless TechComm Tips - STC New England Interchange Keynote 2020
bots
voice (Alexa/Siri/OK Google/IoT)
more!
“chunks, not blobs”
-karen mcgrane
Timeless TechComm Tips - STC New England Interchange Keynote 2020
flare/framemaker/robohelp/webhelp outputs are all:
? html
? css
? javascript
docs as code
use the same tools your developers do
? text editors (ms vs code, notepad++)
? unstructured languages
? markdown/asciidoc/restructuredtext
? oXygen xml editor has built-in md conversion
? github/gitlab/microsoft azure
? slack/ms teams
? there are stc-related slacks if you want to get
your feet wet
Timeless TechComm Tips - STC New England Interchange Keynote 2020
Timeless TechComm Tips - STC New England Interchange Keynote 2020
? news
? breaking
? industry
? conference coverage
? research
? what are your customers doing/thinking?
? what are their pain points?
? what are your competitors doing?
? crowdsourcing
? anyone know why x is crashing when y?
? what’s best practice for x?
? you can answer questions, too!
Timeless TechComm Tips - STC New England Interchange Keynote 2020
? edmarsh.com
? @edmarsh
? edmarsh.com/podcast
? contentcontent.info
? http://www.linkedin.com/in/edmarsh/
? http://www.slideshare.net/theedmarsh/
yes, please.
Ad

Recommended

Adding value as a technical communicator #CONDUIT2019
Adding value as a technical communicator #CONDUIT2019
Ed Marsh
?
How To be a Backend developer
How To be a Backend developer
Ramy Hakam
?
About me - Rothschild Partnerships
About me - Rothschild Partnerships
Moaid Hathot
?
Modern front end development
Modern front end development
Tomislav Mesi?
?
Web Application
Web Application
Sameer Poudel
?
2020 Adding value as a technical communicator STC IDL SIG
2020 Adding value as a technical communicator STC IDL SIG
Ed Marsh
?
The Future of Technical Communication (Future of #techcomm)
The Future of Technical Communication (Future of #techcomm)
Larry Kunz
?
Tinker Tailor Soldier Sailor - What you Can Do as a Technical Communicator
Tinker Tailor Soldier Sailor - What you Can Do as a Technical Communicator
Beth Agnew
?
Data driven content - March 2018 STC IDL SIG
Data driven content - March 2018 STC IDL SIG
Ed Marsh
?
Charles Rygula: Value Beyond Words
Charles Rygula: Value Beyond Words
Jack Molisani
?
his article focuses on new job roles and responsibilitie
his article focuses on new job roles and responsibilitie
SusanaFurman449
?
The Changing Face of TechComm and the Society for Technical Communication
The Changing Face of TechComm and the Society for Technical Communication
Scott Abel
?
COVID-19: The future of organisations and the future of technical communication
COVID-19: The future of organisations and the future of technical communication
Ellis Pratt
?
Trends In Technical Communication
Trends In Technical Communication
Bogo Vatovec
?
Technical Communication and User Communities
Technical Communication and User Communities
Bogo Vatovec
?
On working in Particular
On working in Particular
Mauro Servienti
?
How we daily manage and work in a dispersed company: Particular Software
How we daily manage and work in a dispersed company: Particular Software
Mauro Servienti
?
Part Time Agile
Part Time Agile
Dima Malenko
?
Trends in Technical Communications in North America
Trends in Technical Communications in North America
Chris LaRoche
?
Tech gig presentation - pmi
Tech gig presentation - pmi
TechGigDotCom
?
Tech Update Summary from Blue Mountain Data Systems September 2015
Tech Update Summary from Blue Mountain Data Systems September 2015
BMDS3416
?
Success with SharePoint
Success with SharePoint
StoverEffect
?
The Open Manifesto: how to work smarter, supercharge collaboration and (maybe...
The Open Manifesto: how to work smarter, supercharge collaboration and (maybe...
CanadaHelps / MyCharityConnects
?
The business case for better tech comm
The business case for better tech comm
Scriptorium Publishing
?
2016 Conduit Program
2016 Conduit Program
STC-Philadelphia Metro Chapter
?
Tessa Ann Taylor: A Readme
Tessa Ann Taylor: A Readme
Tessa Ann Taylor
?
Supporting the Business Plan : at LavaCon 2012
Supporting the Business Plan : at LavaCon 2012
MarkLewis_HyperWriters
?
Tc on life_support
Tc on life_support
Chris LaRoche
?
Should you care about podcasting? - STC Rocky Mountain chapter 2020
Should you care about podcasting? - STC Rocky Mountain chapter 2020
Ed Marsh
?
Drive your Docs with Data - Conduit Conference 2017
Drive your Docs with Data - Conduit Conference 2017
Ed Marsh
?

More Related Content

Similar to Timeless TechComm Tips - STC New England Interchange Keynote 2020 (20)

Data driven content - March 2018 STC IDL SIG
Data driven content - March 2018 STC IDL SIG
Ed Marsh
?
Charles Rygula: Value Beyond Words
Charles Rygula: Value Beyond Words
Jack Molisani
?
his article focuses on new job roles and responsibilitie
his article focuses on new job roles and responsibilitie
SusanaFurman449
?
The Changing Face of TechComm and the Society for Technical Communication
The Changing Face of TechComm and the Society for Technical Communication
Scott Abel
?
COVID-19: The future of organisations and the future of technical communication
COVID-19: The future of organisations and the future of technical communication
Ellis Pratt
?
Trends In Technical Communication
Trends In Technical Communication
Bogo Vatovec
?
Technical Communication and User Communities
Technical Communication and User Communities
Bogo Vatovec
?
On working in Particular
On working in Particular
Mauro Servienti
?
How we daily manage and work in a dispersed company: Particular Software
How we daily manage and work in a dispersed company: Particular Software
Mauro Servienti
?
Part Time Agile
Part Time Agile
Dima Malenko
?
Trends in Technical Communications in North America
Trends in Technical Communications in North America
Chris LaRoche
?
Tech gig presentation - pmi
Tech gig presentation - pmi
TechGigDotCom
?
Tech Update Summary from Blue Mountain Data Systems September 2015
Tech Update Summary from Blue Mountain Data Systems September 2015
BMDS3416
?
Success with SharePoint
Success with SharePoint
StoverEffect
?
The Open Manifesto: how to work smarter, supercharge collaboration and (maybe...
The Open Manifesto: how to work smarter, supercharge collaboration and (maybe...
CanadaHelps / MyCharityConnects
?
The business case for better tech comm
The business case for better tech comm
Scriptorium Publishing
?
2016 Conduit Program
2016 Conduit Program
STC-Philadelphia Metro Chapter
?
Tessa Ann Taylor: A Readme
Tessa Ann Taylor: A Readme
Tessa Ann Taylor
?
Supporting the Business Plan : at LavaCon 2012
Supporting the Business Plan : at LavaCon 2012
MarkLewis_HyperWriters
?
Tc on life_support
Tc on life_support
Chris LaRoche
?
Data driven content - March 2018 STC IDL SIG
Data driven content - March 2018 STC IDL SIG
Ed Marsh
?
Charles Rygula: Value Beyond Words
Charles Rygula: Value Beyond Words
Jack Molisani
?
his article focuses on new job roles and responsibilitie
his article focuses on new job roles and responsibilitie
SusanaFurman449
?
The Changing Face of TechComm and the Society for Technical Communication
The Changing Face of TechComm and the Society for Technical Communication
Scott Abel
?
COVID-19: The future of organisations and the future of technical communication
COVID-19: The future of organisations and the future of technical communication
Ellis Pratt
?
Trends In Technical Communication
Trends In Technical Communication
Bogo Vatovec
?
Technical Communication and User Communities
Technical Communication and User Communities
Bogo Vatovec
?
How we daily manage and work in a dispersed company: Particular Software
How we daily manage and work in a dispersed company: Particular Software
Mauro Servienti
?
Trends in Technical Communications in North America
Trends in Technical Communications in North America
Chris LaRoche
?
Tech gig presentation - pmi
Tech gig presentation - pmi
TechGigDotCom
?
Tech Update Summary from Blue Mountain Data Systems September 2015
Tech Update Summary from Blue Mountain Data Systems September 2015
BMDS3416
?
Success with SharePoint
Success with SharePoint
StoverEffect
?
The Open Manifesto: how to work smarter, supercharge collaboration and (maybe...
The Open Manifesto: how to work smarter, supercharge collaboration and (maybe...
CanadaHelps / MyCharityConnects
?
Supporting the Business Plan : at LavaCon 2012
Supporting the Business Plan : at LavaCon 2012
MarkLewis_HyperWriters
?

More from Ed Marsh (6)

Should you care about podcasting? - STC Rocky Mountain chapter 2020
Should you care about podcasting? - STC Rocky Mountain chapter 2020
Ed Marsh
?
Drive your Docs with Data - Conduit Conference 2017
Drive your Docs with Data - Conduit Conference 2017
Ed Marsh
?
NEWEST VERSION Social media and Podcasting for tech communicators TCCamp 2016
NEWEST VERSION Social media and Podcasting for tech communicators TCCamp 2016
Ed Marsh
?
Social media for technical communicators - Conduit 2016 #STCPMC16
Social media for technical communicators - Conduit 2016 #STCPMC16
Ed Marsh
?
Social Media for Technical Communicators
Social Media for Technical Communicators
Ed Marsh
?
Auto Racing/Motorsports Photography - Ed Marsh
Auto Racing/Motorsports Photography - Ed Marsh
Ed Marsh
?
Should you care about podcasting? - STC Rocky Mountain chapter 2020
Should you care about podcasting? - STC Rocky Mountain chapter 2020
Ed Marsh
?
Drive your Docs with Data - Conduit Conference 2017
Drive your Docs with Data - Conduit Conference 2017
Ed Marsh
?
NEWEST VERSION Social media and Podcasting for tech communicators TCCamp 2016
NEWEST VERSION Social media and Podcasting for tech communicators TCCamp 2016
Ed Marsh
?
Social media for technical communicators - Conduit 2016 #STCPMC16
Social media for technical communicators - Conduit 2016 #STCPMC16
Ed Marsh
?
Social Media for Technical Communicators
Social Media for Technical Communicators
Ed Marsh
?
Auto Racing/Motorsports Photography - Ed Marsh
Auto Racing/Motorsports Photography - Ed Marsh
Ed Marsh
?
Ad

Recently uploaded (20)

Presentation about the current products.pptx
Presentation about the current products.pptx
ikrammustafa51
?
Quarter 3 Program Implementation Review and Performance Assessment
Quarter 3 Program Implementation Review and Performance Assessment
LaMariaAngelicaPunay
?
Current Affairs for Prelims (Schemes) 2024 (1).pptx
Current Affairs for Prelims (Schemes) 2024 (1).pptx
malavikasprinklr
?
S6 Hand-out.pdf,sjjdjejejjdjejdjdjdjddks
S6 Hand-out.pdf,sjjdjejejjdjejdjdjdjddks
nicebe546
?
700691372-Types-of-Characters-PowerPoint.pptx
700691372-Types-of-Characters-PowerPoint.pptx
rossanthonytan1
?
Untitled.pdf of mastering your offer to u
Untitled.pdf of mastering your offer to u
ArponSaha8
?
ndss2024xxxxxxxxxxxxxxxxx_slides (1).ppsx
ndss2024xxxxxxxxxxxxxxxxx_slides (1).ppsx
rnkaushal2
?
merged_presentation_choladeck (1).pptx h
merged_presentation_choladeck (1).pptx h
sukh27012
?
Pakistan Economy presentation pakistan.pptx
Pakistan Economy presentation pakistan.pptx
ikrammustafa51
?
Introduction to Stack.pptx with stack info
Introduction to Stack.pptx with stack info
BhaveshKorane
?
Plant Evaluation and Historical Developments,PPT.pptx
Plant Evaluation and Historical Developments,PPT.pptx
7300511143
?
最新版意大利拉奎拉大学毕业证(础蚕鲍滨尝础毕业证书)原版定制
最新版意大利拉奎拉大学毕业证(础蚕鲍滨尝础毕业证书)原版定制
taqyea
?
szza009 (1).pdfdsrgggsdggggggggggggggggggggggg
szza009 (1).pdfdsrgggsdggggggggggggggggggggggg
ath67927
?
Biography and career history of Dr. Gabriel Carabello
Biography and career history of Dr. Gabriel Carabello
Dr. Gabriel Carabello
?
Behavioral Skills / Employability Skills
Behavioral Skills / Employability Skills
bonophool banerjee
?
RainWater Harvesting-ppt.pptx
RainWater Harvesting-ppt.pptx
shibamguin2003
?
S Pomeroy - Resume - Financial Leadership Role ATSV2 (06 13 25).pdf
S Pomeroy - Resume - Financial Leadership Role ATSV2 (06 13 25).pdf
ndhsshare1
?
3. Job Attitude & Job Satisfaction. .ppt
3. Job Attitude & Job Satisfaction. .ppt
obaidullah200107153
?
complete guide for youtube tv and creators
complete guide for youtube tv and creators
dpknihal
?
Nsqf vhse admission career guidance kerala
Nsqf vhse admission career guidance kerala
anjaliparvathy2000
?
Presentation about the current products.pptx
Presentation about the current products.pptx
ikrammustafa51
?
Quarter 3 Program Implementation Review and Performance Assessment
Quarter 3 Program Implementation Review and Performance Assessment
LaMariaAngelicaPunay
?
Current Affairs for Prelims (Schemes) 2024 (1).pptx
Current Affairs for Prelims (Schemes) 2024 (1).pptx
malavikasprinklr
?
S6 Hand-out.pdf,sjjdjejejjdjejdjdjdjddks
S6 Hand-out.pdf,sjjdjejejjdjejdjdjdjddks
nicebe546
?
700691372-Types-of-Characters-PowerPoint.pptx
700691372-Types-of-Characters-PowerPoint.pptx
rossanthonytan1
?
Untitled.pdf of mastering your offer to u
Untitled.pdf of mastering your offer to u
ArponSaha8
?
ndss2024xxxxxxxxxxxxxxxxx_slides (1).ppsx
ndss2024xxxxxxxxxxxxxxxxx_slides (1).ppsx
rnkaushal2
?
merged_presentation_choladeck (1).pptx h
merged_presentation_choladeck (1).pptx h
sukh27012
?
Pakistan Economy presentation pakistan.pptx
Pakistan Economy presentation pakistan.pptx
ikrammustafa51
?
Introduction to Stack.pptx with stack info
Introduction to Stack.pptx with stack info
BhaveshKorane
?
Plant Evaluation and Historical Developments,PPT.pptx
Plant Evaluation and Historical Developments,PPT.pptx
7300511143
?
最新版意大利拉奎拉大学毕业证(础蚕鲍滨尝础毕业证书)原版定制
最新版意大利拉奎拉大学毕业证(础蚕鲍滨尝础毕业证书)原版定制
taqyea
?
szza009 (1).pdfdsrgggsdggggggggggggggggggggggg
szza009 (1).pdfdsrgggsdggggggggggggggggggggggg
ath67927
?
Biography and career history of Dr. Gabriel Carabello
Biography and career history of Dr. Gabriel Carabello
Dr. Gabriel Carabello
?
Behavioral Skills / Employability Skills
Behavioral Skills / Employability Skills
bonophool banerjee
?
RainWater Harvesting-ppt.pptx
RainWater Harvesting-ppt.pptx
shibamguin2003
?
S Pomeroy - Resume - Financial Leadership Role ATSV2 (06 13 25).pdf
S Pomeroy - Resume - Financial Leadership Role ATSV2 (06 13 25).pdf
ndhsshare1
?
3. Job Attitude & Job Satisfaction. .ppt
3. Job Attitude & Job Satisfaction. .ppt
obaidullah200107153
?
complete guide for youtube tv and creators
complete guide for youtube tv and creators
dpknihal
?
Nsqf vhse admission career guidance kerala
Nsqf vhse admission career guidance kerala
anjaliparvathy2000
?
Ad

Timeless TechComm Tips - STC New England Interchange Keynote 2020

  • 2. ? 26-year technical writer ? content strategist @ major financial firm ? stc associate fellow 2020(!) ? content content podcast – edmarsh.com/podcast ? lavacon podcast - lavacon.org ? stc “speaking of techcomm” podcast co-host ? contentcontent.info ? @edmarsh
  • 3. This is the moment we’ve been waiting for!
  • 4. you are more than “just a writer” Technical communicator Librarian Translator Detective
  • 5. technical communication is a customer service role ? helping people do their job ? accommodating new and existing content ? quickly responding to user requests and updates
  • 6. help your technical support teams ? are there recurring topics that can be addressed? ? share best practices/war stories ? create connections ? break down silos!
  • 7. what’s in it for me
  • 8. why does it matter? how does it help me? how much of my (physical and mental) bandwidth does this take? what are the benefits to my team/company/? what are the costs/risks? how many resources does this require? how many resources does this alleviate?
  • 9. governance is not a dirty word retain knowledge
  • 11. ? find out how your users write and think ? are you speaking the same language as your users? ? are you considering misspellings/typos? ? are there additional keywords you can add? ? generate new topics
  • 12. robohelp and madcap both have analytics products
  • 14. git (version control) doesn't work well with pdfs pdfs are evil on mobile just because a spec requires pdf, it doesn’t mean that your users want it
  • 15. let go of the words (sorry, ginny redish)
  • 16. the number of words you write is not a measure of success (MoS) or Objectives and Key Results (OKRs) ?delivery and engagement are management (and the bottom line) doesn’t care if you use two spaces after a period, or if you use ‘displays’ or ‘appears’
  • 22. flare/framemaker/robohelp/webhelp outputs are all: ? html ? css ? javascript
  • 23. docs as code use the same tools your developers do ? text editors (ms vs code, notepad++) ? unstructured languages ? markdown/asciidoc/restructuredtext ? oXygen xml editor has built-in md conversion ? github/gitlab/microsoft azure ? slack/ms teams ? there are stc-related slacks if you want to get your feet wet
  • 26. ? news ? breaking ? industry ? conference coverage ? research ? what are your customers doing/thinking? ? what are their pain points? ? what are your competitors doing? ? crowdsourcing ? anyone know why x is crashing when y? ? what’s best practice for x? ? you can answer questions, too!
  • 28. ? edmarsh.com ? @edmarsh ? edmarsh.com/podcast ? contentcontent.info ? http://www.linkedin.com/in/edmarsh/ ? http://www.slideshare.net/theedmarsh/