--- title: "I’d Rather Be Writing blog" description: "{% for post in paginator.posts %} {{ post.title }} {{ post.date | date:" canonical_url: https://idratherbewriting.com/page57/index.html --- > For AI agents: a documentation index is available at https://idratherbewriting.com/llms.txt. Markdown versions of all pages are available by appending .md to any page URL. # I’d Rather Be Writing blog [Upcoming presentation: Jekyll versus DITA: Bridging the Gap between Tech Comm and the Web](https://idratherbewriting.com/2015/05/10/upcoming-presentation-jekyll-versus-dita-bridging-the-gap-between-tech-comm-and-the-web/) May 10, 2015 • [dita](https://idratherbewriting.com/category-dita), [jekyll](https://idratherbewriting.com/category-jekyll) May 16, 2015 update: For the recording and slides, see this post. If you're in the San Francisco Bay area (near Oakland, actually), you might be interested in an upcoming presentation I'm giving to the STC Berkeley chapter this Wednesday. Details are on the STC Berkeley chapter site. I also included the description below: Jekyll versus DITA: Bridging the Gap between Tech Comm and the Web Although the web continues to burst at the seams w... [New series: User-centered documentation](https://idratherbewriting.com/2015/04/23/new-series-user-centered-documentation/) Apr 23, 2015 • [user-centered-documentation](https://idratherbewriting.com/category-user-centered-documentation) User-centered documentation 1.0 Podcast: How to Create User-Centered Documentation, Interview with Joe Sokohl 1.1 Writing User-Centered Documentation, or, My Best Days as a Technical Writer 1.2 → New series: User-centered documentation 1... [Final analysis between DITA and Jekyll](https://idratherbewriting.com/2015/04/15/final-analysis-between-dita-and-jekyll/) Apr 15, 2015 • [dita](https://idratherbewriting.com/category-dita), [jekyll](https://idratherbewriting.com/category-jekyll) Jekyll versus DITA 1.0 Check out Ed Marsh's podcast, and also My New series: Jekyll versus DITA 1.1 Authoring with Markdown in Jekyll versus Authoring with DITA in OxygenXML 1.2 Variables and conditional processing in Jekyll versus DITA ... [Producing PDFs in DITA versus Jekyll](https://idratherbewriting.com/2015/04/14/producing-pdfs-in-dita-versus-jekyll/) Apr 14, 2015 • [dita](https://idratherbewriting.com/category-dita), [jekyll](https://idratherbewriting.com/category-jekyll) Jekyll versus DITA 1.0 Check out Ed Marsh's podcast, and also My New series: Jekyll versus DITA 1.1 Authoring with Markdown in Jekyll versus Authoring with DITA in OxygenXML 1.2 Variables and conditional processing in Jekyll versus DITA ... [Reviewing content in DITA versus Jekyll](https://idratherbewriting.com/2015/04/13/reviewing-markdown-content/) Apr 13, 2015 • [dita](https://idratherbewriting.com/category-dita), [jekyll](https://idratherbewriting.com/category-jekyll), [blogging](https://idratherbewriting.com/category-blogging), [findability](https://idratherbewriting.com/category-findability), [java](https://idratherbewriting.com/category-java), [javascript](https://idratherbewriting.com/category-javascript) Jekyll versus DITA 1.0 Check out Ed Marsh's podcast, and also My New series: Jekyll versus DITA 1.1 Authoring with Markdown in Jekyll versus Authoring with DITA in OxygenXML 1.2 Variables and conditional processing in Jekyll versus DITA ... [Creating links in DITA versus Jekyll](https://idratherbewriting.com/2015/04/06/creating-links-in-dita-versus-jekyll/) Apr 6, 2015 • [dita](https://idratherbewriting.com/category-dita), [jekyll](https://idratherbewriting.com/category-jekyll) Jekyll versus DITA 1.0 Check out Ed Marsh's podcast, and also My New series: Jekyll versus DITA 1.1 Authoring with Markdown in Jekyll versus Authoring with DITA in OxygenXML 1.2 Variables and conditional processing in Jekyll versus DITA ... [Newbie to Technical Writer in 4 Easy Steps](https://idratherbewriting.com/2015/04/03/newbie-to-technical-writer-in-4-easy-steps/) Apr 3, 2015 • [beginners](https://idratherbewriting.com/category-beginners) The following is a guest post from Kaylin Tristano, a new technical writer in the medical software industry. In this post, she shares her tips for transitioning into the field of technical writing. I landed my first technical writing job about four months ago. I'd been working as a librarian and had no writing experience besides a few employee manuals cobbled together in Microsoft Word, so I felt clueless and a little nervous about my new... [Building a table of contents with DITA versus Jekyll](https://idratherbewriting.com/2015/04/02/building-a-table-of-contents-with-dita-versus-jekyll/) Apr 2, 2015 • [dita](https://idratherbewriting.com/category-dita), [jekyll](https://idratherbewriting.com/category-jekyll) Jekyll versus DITA 1.0 Check out Ed Marsh's podcast, and also My New series: Jekyll versus DITA 1.1 Authoring with Markdown in Jekyll versus Authoring with DITA in OxygenXML 1.2 Variables and conditional processing in Jekyll versus DITA ... [Creating re-usable chunks (conref) in Jekyll versus DITA](https://idratherbewriting.com/2015/04/01/creating-re-usable-chunks-conref-in-jekyll-versus-dita/) Apr 1, 2015 • [dita](https://idratherbewriting.com/category-dita), [jekyll](https://idratherbewriting.com/category-jekyll) Jekyll versus DITA 1.0 Check out Ed Marsh's podcast, and also My New series: Jekyll versus DITA 1.1 Authoring with Markdown in Jekyll versus Authoring with DITA in OxygenXML 1.2 Variables and conditional processing in Jekyll versus DITA ... [Variables and conditional processing in Jekyll versus DITA](https://idratherbewriting.com/2015/03/26/variables-and-conditional-processing-jekyll-versus-dita/) Mar 26, 2015 • [dita](https://idratherbewriting.com/category-dita), [jekyll](https://idratherbewriting.com/category-jekyll) Jekyll versus DITA 1.0 Check out Ed Marsh's podcast, and also My New series: Jekyll versus DITA 1.1 Authoring with Markdown in Jekyll versus Authoring with DITA in OxygenXML 1.2 → Variables and conditional processing in Jekyll versus DITA ... [Authoring with Markdown in Jekyll versus Authoring with DITA in OxygenXML](https://idratherbewriting.com/2015/03/26/misconception-markdown-is-more-limiting-than-dita-jekyll-versus-dita/) Mar 26, 2015 • [technical-writing](https://idratherbewriting.com/category-technical-writing) Jekyll versus DITA 1.0 Check out Ed Marsh's podcast, and also My New series: Jekyll versus DITA 1.1 → Authoring with Markdown in Jekyll versus Authoring with DITA in OxygenXML 1.2 Variables and conditional processing in Jekyll versus DITA ... [Check out Ed Marsh's podcast, and also My New series: Jekyll versus DITA](https://idratherbewriting.com/2015/03/23/new-series-jekyll-versus-dita/) Mar 23, 2015 • [dita](https://idratherbewriting.com/category-dita), [jekyll](https://idratherbewriting.com/category-jekyll) Jekyll versus DITA 1.0 → Check out Ed Marsh's podcast, and also My New series: Jekyll versus DITA 1.1 Authoring with Markdown in Jekyll versus Authoring with DITA in OxygenXML 1.2 Variables and conditional processing in Jekyll versus DITA ... [Some thoughts on attending tcworld India 2015](https://idratherbewriting.com/2015/03/22/some-thoughts-on-attending-tcworld-india-2015/) Mar 22, 2015 • [technical-writing](https://idratherbewriting.com/category-technical-writing) 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 with others. Understanding tekom tcworld India is the name of a company that puts on the conference. There are two associations that orga... [PDF still trumps browser-based help?](https://idratherbewriting.com/2015/03/19/pdf-still-trumps-browser-based-help/) Mar 19, 2015 • [technical-writing](https://idratherbewriting.com/category-technical-writing) 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. PDF files can be delivered on an installation CD or via the Web. In the past, this technology was mainly used for legacy print documents... [Recording of API documentation workshop (REST and Javadoc) at tcworld India 2015](https://idratherbewriting.com/2015/03/19/recording-of-api-documentation-workshop-rest-and-javadoc-at-tcworld-india-2015/) Mar 19, 2015 • [api-doc](https://idratherbewriting.com/category-api-doc), [podcasts](https://idratherbewriting.com/category-podcasts) Here's a recording of the API documentation workshop that I gave at tcworld India 2015: In this workshop, I cover the following: Overview of API documentation Deep Dive into REST API documentation Deep Dive into Javadoc API documentation This is similar to other presentations I've given on API documentation, except that in this workshop, I finally get a bit into Javadoc during the last 30 minutes. I also have more activities. Here's t... [« Previous](https://idratherbewriting.com/page56/) Page: 57 of 174 [» Next](https://idratherbewriting.com/page58/)