Adobe Robohelp

Get new posts delivered straight to your inbox.

Subscriber count: 4,039

Stitcher radio

follow us in feedly

Want more tech comm blogs to follow? See my Tech Comm Collection of Blogs on Feedly.

Adobe FrameMaker

Recording: Modern Technical Writing, by Andrew Etter (STC Silicon Valley chapter)

Jan 24, 2017 • api-doc, podcasts, stitcher

Andrew Etter presented about his book, Modern Technical Writing, to the STC Silicon Valley chapter on January 24, 2017 in Santa Clara, California. In the presentation, Andrew talks about the strategies he implemented at Palantir to change to a new way of doing docs. This new way includes having a smaller team, using text editors, writing in plain text, processing pull requests instead of bugs, and more. He dives into lightweight markup syntax, static site generators, version control tools, and more, as well as challenges he has faced.

You can read Andrew’s book here: Modern Technical Writing: An Introduction to Software Documentation . (I also posted a review of his book earlier last year.)

Presentation Description

Here’s a description of the presentation:

In Modern Technical Writing: An Introduction to Software Documentation (an ebook available on Kindle), Andrew Etter argues for a model of technical writing that involves lightweight markup languages (like AsciiDoc and Markdown), static site generators (such as Sphinx), distributed version control systems (like Git or Bitbucket), constantly iterating/updating doc content on your website based on analytics, and more. In this presentation, Andrew will provide a summary of Modern Technical Writing, including a discussion of distributed workflows, static site generators, lessons learned during the publishing process, and more.

You can read more details on the STC Silicon Valley event post.

Video

Here’s a video recording (screen + audio):

Audio

If you just want the audio only, you can listen here:

Listen to this presentation:

You can download the MP3 file, subscribe in iTunes, or listen with Stitcher.

Slides

You can view the slides in PDF here:

More info

If you’d like more, you can also watch a similar presentation Andrew gave to the Write the Docs San Francisco meetup here.

follow us in feedly


Get new posts delivered straight to your inbox.

Subscriber count: 4,039

About Tom Johnson

Tom Johnson

I'm a technical writer based in the California San Francisco Bay area. 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 findability, developer documentation, and more. If you're a professional or aspiring technical writer, be sure to subscribe to email updates using the form above. You can learn more about me here.