Adobe DITA World 2018
Stay current with the latest in tech comm
Keep current with the latest trends in technical communication by subscribing to the I'd Rather Be Writing newsletter. 4,500+ subscribers

Stitcher radio

Search results

Adobe DITA World 2018

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

by Tom Johnson on Jan 24, 2017
categories: api-docpodcastsstitcher

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.

Stay current with the latest in tech comm
Keep current with the latest trends in technical communication by subscribing to the I'd Rather Be Writing newsletter. 4,500+ subscribers

follow us in feedly