Stuff

Essentials

  • Sign up for Leather Penguin Publishing News

    * = required field

    powered by MailChimp!
  • Categories

  • Social

  • Our Fearless Leader

    Tim "TC" Lynch

Writing is like sorting laundry — practical advice for tackling documentation projects

A reader recently asked, This is sort of a beginner question, although I am not technically a beginner. I’ve been helping to maintain a medium sized doc set for a suite of products at a large company for over ten years. I’ve never written a significant document from scratch in my 10+ years as a (Read more...)

10 reasons for moving away from DITA

Several people have asked me why I’m moving away from DITA. During my API workshop at TC Camp, near the end, one experienced DITA person said, What couldn’t you do with DITA in publishing API documentation? Another reader recently said, I’m curious to know why you’re moving away from DITA, since we’re thinking about adopting (Read more...)

API workshop video + audio + slides + workshop files from TC Camp

I recently gave an API workshop at the TC Camp Unconference last weekend in Santa Clara, California. This post includes a video recording of my presentation, along with slides, audio, and workshop files. I actually prepared four separate slide decks for the workshop, but only used 2 and a half of them. I don’t know (Read more...)

Reinventing the table of contents

I’ve been exploring different ways to create a table of contents (TOC). Traditionally, user guides have a long TOC in the left column of each page. This works all right when you have about 50 pages, but when you scale up the doc set to 500 pages, the TOC becomes a bulky, unusable mess. For (Read more...)

Moving from passive to reactive documentation — recording of presentation by Greg Koberger, ReadMe.io founder

The following is a recording of a presentation about passive versus reactive documentation by Greg Koberger, developer and designer for ReadMe.io, a slick new REST API documentation tool. Greg gave this presentation at the STC Silicon Valley chapter meeting on January 12, 2015 in Santa Clara, California. (He gave a similar presentation to a Write (Read more...)