Variables and conditional processing in Jekyll versus DITA

In the previous post, I compared writing in Markdown versus writing in XML. In this post in the series, I want to look at variables and conditional processing between the two platforms. Variables in Jekyll In Jekyll, you can assign a variable a specific value, like this: Now you can use {{dog_name}} in your content Continue Reading »

Some thoughts on attending tcworld India 2015

tcworldindia

I just spent the last week in Bangalore, India. The tcworld India 2015 conference took place on a Thursday and Friday, and I spent Saturday and Sunday exploring the city. This was an eye-opening trip for a number of reasons, and I wanted to capture some of my thoughts and experiences here and share them Continue Reading »

PDF still trumps browser-based help?

writersuathumbsurvey

In the Skills and Technology Survey 2014 by WritersUA, it appears that PDF manuals are the most common deliverable: Support for manuals in the form of PDF (77%) is at the top of the list as the most valued technology component. Using PDF as a delivery format has become a staple in our documentation sets. Continue Reading »

Slides for tcworld India 2015 presentations

tcworldindia

I have the opportunity of attending the tcworld India 2015 conference this week in Bangalore. I’m giving a keynote presentation on the topic of innovation and a workshop on API documentation. I posted my slides here in case you’re interested: Innovation in technical communication (HTML) API documentation workshop (Zip) + workshop files Notes about the Continue Reading »

Pushing content into any format with Jekyll

In the previous post, I talked about help APIs as a way to deliver help inside applications. In this post, I’ll explain how to push your help content into any format. Let’s say that you have three different channels where you want to push your help content. Channel one is an S3 bucket in Amazon Continue Reading »