Switched commenting systems to Disqus

Just a heads up, with comments on my blog, I’m now using Disqus as opposed to the native commenting system in WordPress. This means you’ll need to log in using one of the four methods provided by Disqus (Google, Twitter, Facebook, or Disqus) to leave a comment. Why did I switch from WordPress’ native comments Continue Reading »

How to design documentation for non-linear reading behavior


To account for non-sequential reading behavior, provide your readers with sufficient context to orient themselves with your topic. This is the third post in my series about user-centered documentation. First observations about non-sequential reading In the late 1980s, John Carroll observed non-sequential reading behavior with how people consumed documentation in his seminal book, The Nurnberg Continue Reading »

User-centered documentation slides


This is a post in my on-going series on user-centered documentation. I usually write a series of posts, and then create a slide presentation summarizing my insights at the end. Then I usually give the presentation at some venue. Well, I didn’t have time to write out the posts before giving the presentation this time, Continue Reading »

New series: User-centered documentation


I’m starting a new series on my blog about user-centered documentation. If you’re new to my blog, a series is a collection of posts (usually about 10) focused on the same topic. The series format gives me a chance to explore a topic in depth without publishing a monolithic post all at once. Origins of Continue Reading »

Final analysis between DITA and Jekyll

Jekyll versus DITA: A Comparison of authoring tools and techniques

As the ninth post in this series, I think I’m wrapping it up. This post will contain my final analysis comparing Jekyll with DITA. During this series, I had the misfortune of cutting a tendon in my thumb with a box cutter knife, and so typing has been difficult. I’ve had to wear a cast Continue Reading »