Ferry Vermeulen asked more than 70 tech comm pros -- from both the U.S and Europe -- what their 3 essential tools are. The combination of American and European responses makes for an interesting mix. While the majority of respondents listed either Madcap or XML tools, people also listed a...

I'm a technical writer based in the California San Francisco Bay area. Topics I write about on this blog include the following technical communication topics: Swagger, agile, trends, learning, plain language, quick reference guides, tech comm careers, and certificate programs. I'm...

I asked more than a dozen of the smartest people in tech comm about this, and I came to the conclusion that if I ever wanted to do it, I'd need to embrace an XML format and develop custom semantic tags. One evening I had a dinner conversation with Sarah O'Keefe about moving to XML. Sarah...

Each technical communication conference I attend, one of the activities that attendees look forward to is strolling through the exhibit hall, perusing the various tech comm booths, picking up freebies and fliers, listening to vendor pitches, and generally taking in the tech comm world of...

I'm a technical writer based in the San Francisco Bay area of California. Topics I write about on this blog include technical writing, authoring and publishing tools, API documentation, tech comm trends, visual communication, technical writing career advice, information architecture and...

With the beginning of the 2018 STC elections, I decided to ask the Vice President candidates a few questions to get to know their perspectives on tech comm. The elected VP automatically transitions into the president role the following year after election, so it's an important voting decision....

In another insightful post from Mark Baker, this one called The Tech Comm Paradox, Mark asks why there's no market pressure for good documentation even though bad documentation is a constant source of user complaints. Mark writes, This then is the tech comm paradox: documentation is a common...

Ferry Vermeulen asked more than 70 tech comm pros -- from both the U.S and Europe -- what their 3 essential tools are. The combination of American and European responses makes for an interesting mix. While the majority of respondents listed either Madcap or XML tools, people also listed a...

In an earlier post on value arguments for tech comm, I mentioned that in 2018, I plan to explore some innovative ways to simplify complexity so that I can deepen the value I provide to users. To host this content, I created a new section on my site called "Simplifying Complexity." So far I've...

Below are the lightning talks from the March 29 Write the Docs San Francisco Meetup. You can also play the videos from the San Francisco WTD Youtube channel at this playlist. "Storycraft in SDK documentation" or "A Writer's Theory of Everything", by Elisa Sawyer If you just want the...

 

Related shopping