Technical writing
Updated: Thu Apr 17 2025
Technical writers are a Venn diagram of detective, translator, and librarian.
- Detective: Tracking down information across wikis, SharePoint, Confluence, legacy systems, and Subject Matter Experts (SMEs).
- Librarian: Knowing what information is available, what information users actually need, and where to find it.
- Translator: Tech writers interact with a bunch of folks with differing commands of the English language, as well as those whose priority or focus isn’t on the writing. We get it, we’re all busy. That’s where tech writers and editors come in.
30+ years of experience means I’ve touched on all aspects of technical communication.
- Society for Technical Communication (STC) Associate Fellow.
- Award-winning newsletter editor for STC NY Metro Chapter.
I’ve created:
- Online help
- Multimedia
- Podcasts
- eLearning modules
- Cheat sheets
- Technical illustrations
- Printed manuals
- PDF documentation
- API reference documentation
Related
-
So, you want to be a technical writer?
webinar
Content Wrangler webcast, 2024
-
Pros and Cons of using Markdown for tech docs
panel discussion
Content Wrangler webcast, 2024
-
Adding value as a technical communicator
webinar
STC Instructional Design and Learning special interest group, 2020
-
Timeless TechComm Tips
presentation
STC New England Interchange conference keynote, 2020
-
Drive your docs with data
webinar (video)
STC Instructional Design and Learning special interest group, 2018
-
Creating Beautiful Online Content with Web Fonts
article
STC Intercom magazine, 2017
-
Social media for technical communicators
presentation
STC Philadelphia Metro chapter Conduit conference, 2016
Tools
- Confluence by Atlassian
- Extensible Stylesheet Language Transformation (XSLT) by Open-source
- Flare by MadCap
- FrameMaker by Adobe
- InDesign by Adobe
- Markdown by John Gruber/open-source
- oXygen XML Editor by oXygen
- Photoshop by Adobe
- RoboHelp by Adobe
- SnagIt screen capture by SnagIt
- VS Code by Microsoft