• Sign up for Leather Penguin Publishing News

    * = required field

    powered by MailChimp!
  • Categories

  • Social

  • Our Fearless Leader

    Tim "TC" Lynch

Book Review: The Goldfinch, by Donna Tartt

the_goldfinchI don’t often review fiction on this site because I made a decision long ago to brand this site as being specifically about tech comm. But a couple of recent posts by my blogging friends (Neil Kaplan and Sarah Maddox) remind me that it’s good to show more than one side of a (Read more...)

Writing documentation in an interactive world: Some thoughts on using easyDITA and OxygenXML

Since moving to DITA, I’ve tried to settle on best practices and determine the authoring method that works best for me. I started out using OxygenXML, which is one of the most popular DITA editors. I like OxygenXML because it’s easy to work with the code. OxygenXML knows when to show you a list (Read more...)

Content Re-use is so much better with DITA (and esp. with OxygenXML)

After my last post on content re-use strategies with Confluence, I realized that while you can do re-use with Confluence, you have to rely on so many third-party plugins, the whole solution tends to feel cobbled together with string and glue. While I initially thought Confluence would simplify authoring and allow me to focus (Read more...)

Back to Top | Comments Off

Strategies for content re-use in Confluence

I’ve been knee-deep in Atlassian Confluence lately, analyzing the best way to re-use content. In this post, I’ll describe a fictitious scenario that resembles an advanced content re-use situation and then explore various strategies for re-use.

The scenario

Suppose you’re creating a bicycle manual for a Trek 7.3 FX (which happens to be the exact bike I recently bought). (Read more...)

Back to Top | Comments Off

The part of the brain you should listen to when writing

caudate nucleusIn This is your brain on writing, Carl Zimmer writes:

A novelist scrawling away in a notebook in seclusion may not seem to have much in common with an NBA player doing a reverse layup on a basketball court before a screaming crowd. But if you could peer inside their heads, you might see (Read more...)