Name: January 2017: Writing tech docs like a hacker with Jekyll
Start: 2017-01-18T18:30:00-05:00
End: 2017-01-18T21:30:00-05:00

This event is online. Remote connection details will be provided to registrants up to 6:30 am on January 18, 2017.

Static site generators are a new breed of documentation tools that are much more common in engineering groups where developers contribute to the documentation.

Jekyll is one of the most popular static site generators, but it is highly similar to others in the same category such as Docpad, Middleman, Wintersmith, and Octopress. You can see a more comprehensive list of the top static site generators at Staticgen.com.

Jekyll projects approach doc as code. All the files are open and editable within a code editor, and your files can live in the same repository as your program code or within the same version control workflow.

Although developers and web engineers love Jekyll, there are significant challenges to overcome when adopting Jekyll for any robust tech comm publishing scenario. Some of these challenges include conditional filtering, single sourcing, PDF output, a robust TOC, search, context-sensitive help, collaboration, SME review, and more.

In this presentation, Tom Johnson will share his adventures in using Jekyll and how he dealt with each of these challenges.

You can preview the slides here: http://idratherbewriting.com/ files/ jekyllwritetechdocslikehackerstc (http://idratherbewriting.com/files/jekyllwritetechdocslikehackerstc)

About the speaker

Tom Johnson is a technical writer at Amazon Lab126 (http://www.lab126.com (http://www.lab126.com/)) in Sunnyvale, California. He is most well-known in the community for his tech comm blog at http://idratherbewriting.com (http://idratherbewriting.com/). You can access the Jekyll documentation theme and other resources from the Jekyll tab on Tom’s site. You can contact Tom through the following:

Email: tom@idratherbewriting.com

Website: http://idratherbewriting.com (http://idratherbewriting.com/)

Twitter: @tomjohnson

Greg Campbell

Technical Communication P2P

Technology

Product Design

Software Development

Software Engineering

Content Strategy

Product Development

Software Product Management

Computer Programming

Software Architecture

New Product Development: Software & Tech

Product Management

Software Engineers

January 2017: Writing tech docs like a hacker with Jekyll

Share

Technical Communication P2P

January 2017: Writing tech docs like a hacker with Jekyll

Technical Communication P2P

Details

Members are also interested in