When you don't feel like blogging, is it time to blog?

You've probably heard the saying, when you don't feel like praying, pray. When you don't feel like serving, serve. Feelings follow actions, so as soon as you start doing something, eventually you start feeling the desire to do it. But is the same true for blogging? If you don't feel like blogging, is it time to blog? This past couple of weeks I haven't felt much like blogging or podcasting. Not sure why. I spent a good chunk of time doin...

Tips for Distributing the Workload Among Your Team -- Answering a Reader's Question

Sebastian asks, I have been searching the web for information about how to divide workload among writers as the the workload--and the department itself!--grow. I am thrilled to find your blog! I am a new writer in a Health Information Systems doc group. We write for 120 products, maintain 600+ documents (several output formats). Do you know of any effective strategies/tools/medications? What kind of documents do you produce? We produce o...

Venn Diagram of What a Blog Should Be About

Jane made this cool little Venn diagram the other week. It's intriguing and feels true, but it's meaning seems just out of reach. What do you think it means?

When can I say "janky" in my on-screen text?

In the on-screen text in WordPress, on the Write > Page screen, I ran across the following help text. Just yesterday my colleague Ben was asking how I felt about the use of contractions in help. Contractions? We've moved far beyond contractions. We're now using terms like janky. How I would love to publicly insult the applications I document! E.g., Hey, we know this feature is kludgey, but we couldn't find an easy fix. Hang on -- the ...

WordPress Training This Saturday 9 am to Noon

WordPress Training Course Date: Saturday, July 19 Time: 9 am to noon MST Cost: $99 If you're interested in WordPress training, I'm holding a course this Saturday from 9 a.m. to noon MST over the web. Click the WordPress Training button on my navigation bar for details about what's covered and the cost. Speaking of WordPress, here's a great post from Mashable about 20 must-have compatible plugins for WordPress 2.5. I especially recommend ...

WordPress Tip: WordPress Image Galleries — Give Your Photo Galleries a Lightbox/Slideshowesque Display

Jan 2009 Update: Please see the note at the bottom of this page. Because I had trouble using captions with the Photojar plugin, I deactivated the plugin. A WordPress image gallery allows you to create a sharp-looking presentation for your photos or images. With just a couple of plugins and tweaks and some basic understanding of the WordPress gallery tag, you can make a Lightbox/Slideshowesque display of your gallery images without any cus...

WordPress Tip: Woopra — Enough Live Site Stats to Write a Dissertation

Woopra is a new website analytics tracking tool that gives you enough live stats to write a dissertation. It takes analytics tracking a step further than Google Analytics and allows you to see a live map of visitors on your site — what they're reading, what paths they've taken, what country they're from, how long they've been on your site, and so on. If visitors have left a comment and haven't cleared the cookies in their browser, they ev...

Quick Reference Guides: The Poetry of Technical Writing

Quick reference guides 1.0 → Quick Reference Guides: The Poetry of Technical Writing 1.1 Quick Reference Guide Formats -- Tips for Finding Attractive Layouts 1.2 STC Presentation this Thursday: "Quick Reference Guides: Short and Sweet Technical Documentation" ...

The Intersection of the Personal and Professional, or, Why My Attempts at Nonfiction Essays in Grad School Bombed

I wrote this post for Poewar.com last year, but I like to keep my own writing consolidated on my site, so I've added it here. Literary nonfiction gets its energy, Richard Locke says, from the intersection of the personal and professional. The tension and appeal of literary nonfiction comes from the interplay between the writer's personal experiences and the topic he or she is exploring. Richard Locke headed the Literary Nonfiction Writing...

Approaching Help as Solutions to Problems — An Interesting Format from the CSS Cookbook

At Borders or Barnes & Noble, I often browse the computer books to see the different ways writers approach help material — especially how they approach the same help material. The other day I wanted a book on CSS, so I pulled four available CSS books off the shelf and began browsing them. Each book looked respectable, but the CSS Cookbook, by Christopher Schmitt, had a unique format that caught my attention and convinced me to buy it....

Interview with Me in TechCraft

Rahul Prabhakar, editor of the TechCraft newsletter, which accompanies the Technical Writers of India listserv, published an interview with me in the latest issue (June 2008). You can read it here: Techcraft e-Newsletter Volume 38 June 2008. It's in the "Spotlight" section near the end. (You can also log into Yahoo and read it here by going to the June 2008 folder, but Rahul gave me permission to post the PDF directly.) Tech Writers of In...

"What's Next?" -- A Nice Way to End Help Topics

At the end of many topics in Flare's help, a What's Next? section appears. For example, in a topic on Creating a Table of Contents, the What's Next? feature guesses what you'll want to do next -- enable the table of contents in your target. See the following image. Having used Flare's help for a while, I really like this What's Next? feature. For me, it works better than the See Also references, which are more common. (One time I asked a...

14 Widespread Myths about Technical Writing

Jefferson McClure added a thought-provoking article link on WriterRiver.com titled "Myths of Technical Writing." The article is by Bob Doyle and appears on the dita.xml.org wiki site here. In the article, Doyle and other wiki contributors mention 4 myths about technical writing: The GlueText Myth The Stem Sentences Myth The Front-Matter Page-Numbering Myth The Callouts on Graphics Myth You'll have to read the original for the details. ...

My Compromise with SharePoint -- What Works and What Doesn't

In a previous post, I mentioned my desire to use SharePoint as a help authoring platform because it provides a Web 2.0 experience that is company-sanctioned. SharePoint not only has blogs, wikis, and RSS feeds, but also integrates with Active Directory, Outlook 2007, and has integrated search across all content. However, the more I tried to use SharePoint as a help authoring tool, the more problems I ran into. SharePoint doesn't handle ro...

My WordPress Site Was Hacked

My site was hacked today. Usually when someone says "my site's been hacked," the first response is, are you sure you didn't screw something up yourself? Yes, I'm sure. Someone twittered that my tinyurl was showing a login page. Actually, for me it showed the install page below: But I hadn't been upgrading or installing anything. Something was definitely wrong. I wondered if it was a hacker, so I searched the WordPress forums and found a...