Search results

Recording and slides from "Jekyll vs. DITA: Bridging the Gap Between Tech Comm and the Web" presentation

Series: Jekyll versus DITA

by Tom Johnson on May 14, 2015
categories: dita • jekyll • podcasts

  1. 1.0 Check out Ed Marsh's podcast, and also My New series: Jekyll versus DITA
  2. 1.1 Authoring with Markdown in Jekyll versus Authoring with DITA in OxygenXML
  3. 1.2 Variables and conditional processing in Jekyll versus DITA
  4. 1.3 Creating re-usable chunks (conref) in Jekyll versus DITA
  5. 1.4 Building a table of contents with DITA versus Jekyll
  6. 1.5 Reviewing content in DITA versus Jekyll
  7. 1.6 Producing PDFs in DITA versus Jekyll
  8. 1.7 Creating links in DITA versus Jekyll
  9. 1.8 Final analysis between DITA and Jekyll
  10. 1.9 → Recording and slides from "Jekyll vs. DITA: Bridging the Gap Between Tech Comm and the Web" presentation

Yesterday I gave a presentation to STC Berkeley about ways to bridge the gap between tech comm tools and web development tools. After talking about innovation patterns, I focused on static site generators, specifically Jekyll. I also explained how DITA compares to Jekyll.

Slides

Here are the slides:

Jekyll vs DITA presentation

Audio recording

Here's the MP3 audio file:

Listen here:

(Sorry, my attempts to record the screen using Camtasia failed -- Camtasia crashed. I think my MacBook Pro Retina display didn't jive with the old projector I was hooked into.)

Links to more information

Note that this presentation is similar to the keynote I gave at tcworld India. Personally, I felt the India presentation went better. If I were giving this presentation again, I would probably drop the DITA comparison, shorten the exploration of innovation, and just show static site generators in depth.

Also see the Jekyll Versus DITA series for more detail about the tool comparisons.

About Tom Johnson

Tom Johnson

I'm an API technical writer based in the Seattle area. On this blog, I write about topics related to technical writing and communication — such as software documentation, API documentation, AI, information architecture, content strategy, writing processes, plain language, tech comm careers, and more. Check out my API documentation course if you're looking for more info about documenting APIs. Or see my posts on AI and AI course section for more on the latest in AI and tech comm.

If you're a technical writer and want to keep on top of the latest trends in the tech comm, be sure to subscribe to email updates below. You can also learn more about me or contact me. Finally, note that the opinions I express on my blog are my own points of view, not that of my employer.

© 2024 Tom Johnson