Stuff

Essentials

  • Sign up for Leather Penguin Publishing News

    * = required field

    powered by MailChimp!
  • Categories

  • Social

  • Our Fearless Leader

    Tim "TC" Lynch

Slides and recording for “Perfecting the audio narration in instructional video” at Info Dev World

Today at Information Development World I presented “Perfecting the audio narration in instructional video.” Here are my slides and recording.

Perfecting the audio narration in instructional video from Tom Johnson

PowerPoint in other format: pptx | zip

Length: 50 min.

Download MP3 (right-click and select Save As)

Also, I know I posted it earlier, (Read more...)

Outside the tech comm tool bubble, there is a wide, wide world

If you hang out in tech comm circles, attend STC meetings and technical writing conferences, and interact on tech writer blogs and forums, you might think the general tool options for professional technical writing goes something like this: You can use a help authoring tool, such as Madcap Flare, Framemaker, or Author-it. You can also (Read more...)

Back to Top | Comments Off

Why developers will never adopt DITA

Ever wonder why developers resist DITA so much? Take a look at this comparison. Here are two ways to describe a simple task of printing a page.

DITA syntax

<task id="task_mhs_zjk_pp">
    <title>Printing a page</title>
    <taskbody>
<steps>
        <stepsection>To print a page:</stepsection>
    <step>
        <cmd>Go to <menucascade>
            <uicontrol>File</uicontrol><uicontrol>Print</uicontrol>
        </menucascade></cmd>
    </step>
    <step>
        <cmd>Click the <uicontrol>Print</uicontrol> button.</cmd>
    </step>
</steps>
    </taskbody>
 (Read more...)
Back to Top | Comments Off

Two major Confluence problems: poor content re-use and lack of wiki markup

The other day I tweeted about a brief frustration with Confluence:

And a couple of people asked me for a post with more detail.

Back to Top | Comments Off

Using collapsible sections to bring tasks and concepts together (DITA)

Last week I showed how to integrate a sliding side panel into OxygenXML’s webhelp output. In this post, I show you how to integrate collapsible show/hide sections. As before, I’m using DITA as the structured content, which adds another element of complexity to the setup.

Demo

For a demo of the show/hide functionality, see (Read more...)

Back to Top | Comments Off