WordPress Tip: Implement WordPress's Threaded Comments

WordPress's threaded comments feature is not entirely now; it's been around since 2.7 (the current version of WordPress is 2.7.1). But even though under Settings > Discussion you see the ability to activate threaded comments and indicate how many levels deep you want it to be, you have to actually make some changes to your theme for threaded comments to work. The following screenshot shows an example of threaded comments. Threaded Comm...

WordPress Tip: 10 Reasons Why I Like WordPress

When choosing a blog platform, you have a variety of options: Drupal, Movable Type, Typepad, Blogger, Joomla, Expression Engine, WordPress.com, self-hosted WordPress, and others. But when you start researching the options, WordPress seems to have at least 10 main strengths over its competitors: Abundant Themes. You can choose from hundreds of already developed themes to immediately apply to your blog, so that you don't have to design yo...

Anne Gentle on her Forthcoming Book, Conversation and Community: The Social Web for Documentation

Listen here: In this podcast, I talk with Anne Gentle about her forthcoming book, Conversation and Community: The Social Web for Documentation. Anne explains how we've transitioned from the Age of Information to the Age of Interaction, using social web tools to find the information we need. She builds on her experiences with One Laptop per Child, Book Sprints, and her experiences as a corporate blogger for BMC software. ...

Following the NBA Can Make You a Better Technical Writer

Even if you aren't watching the NBA playoffs (professional basketball), you'll probably get the point of this post. Watching a pro basketball team, one thing you realize is that each player has a special position and strength, and they play those strengths rather than their weaknesses. Kenyon Martin screens for Carmelo Anthony For example, even when Kenyon Martin has an open jump shot 20 feet away, he often doesn't take the shot but inste...

Your WordPress Site Can Get Hacked If You Don't Have This

I helped another person whose WordPress site was hacked this weekend. I've noticed a trend about sites that get hacked. Most of the people installed their WordPress blog either long ago, before the right security phrases were included in the wp-config.php file, or they installed WordPress through an auto-installer that didn't insert the right security phrases. The wp-config.php file is the key file that contains your database name and pas...

STC Toronto's New Five-and-Five Chapter Model

Listen here: In this podcast, I talk with Anna Parker Richards, incoming president of the STC Toronto chapter, about their event-driven chapter model, in which they replace regular meetings with periodic all-day events, charging between $50 to $150 per person. They haven't entirely discarded meetings in favor of events, but have instead supplemented the events with social gatherings. Their new model, the Five and Five Mo...

Richard Hamilton's XML Press Imprint

Listen here: In this podcast, I talk with Richard Hamilton about his new publishing imprint, XML Press. Richard started XML Press to serve the needs of technical communicators, publishing books on topics that may not get traction from large publishing houses due to the limited audience, but which perfectly fit a smaller, niche technical communication audience. Focusing on practical topics that technical communicators can...

Converting Readers from Casual Subscribers to Devoted Followers

Listen here: At the STC Summit, I ran into someone from Australia who follows my wife's blog fairly regularly and had even brought gifts for her and the kids. It made me reflect on blog subscribers, and how you convert readers from being occasional readers to devoted fans. In this podcast, Kirsty Taylor talks about what she finds appealing about Seagull Fountain (my wife's blog) and other blogs she follows. Kirsty explai...

Sailboats and Cruise Ships, or, How My Work Podcast Was Dwarfed by a Mega Work Podcast

A couple of months ago, I wanted to start a podcast at my work, and so I interviewed someone who has been in our IT department for 28 years about the evolution of the department over the years. The podcast took about a month to get approved, and the week before it was posted, as I was tracking down the person who controlled our iTunes feed and Feedburner, I found that another department, Digital Media, was in the process of launching a fu...

Madcap's Flare-DITA Solution (podcast)

Listen here: In this podcast, Mike Hamilton of Madcap Software talks about their phased approach to handling DITA with Flare. In Phase I, you'll have the ability to import DITA topics and export to webhelp and other targets. In this sense, Flare functions as a transform engine. In Phase 2, you can use Flare for native DITA authoring. Phase 1 is on the cusp of release, but Phase II won't be available until quarter one of ...

The State of Structured Authoring in Technical Communication (podcast)

Listen here: In this podcast, Sarah O'Keefe of Scriptorium Publishing explains the results of their recent survey about the state of structured authoring in technical communication. In the survey, they found that 84% of respondents are either thinking of moving to structured authoring, are in the process of moving to structured authoring, have already adopted structured authoring, or are undecided. Only 16% of respondent...

Drawing as a Tool for Thinking: The Back of the Napkin

Lately I've been reading Dan Roam's The Back of the Napkin: Selling Ideas and Solving Problems Through Pictures. In the book, Roam asserts that drawing pictures can help you solve problems. It's a simple but profound assertion. You're no doubt familiar with the same assertion with writing. Writing is a tool for thinking, a method for unlocking ideas. Writing about something helps you think about it, helps you see the problem more clearly,...

The Best Thing I Did This Week

This past week I started exercising at lunch—it was the best thing I did all week. Given how sedentary the job of technical writing is, you'd think this would be a no brainer. But in fact, it's not. My company's gym is rarely used. I see just two or three people (out of hundreds) in there during lunch. While working out, I also listen to podcasts. Lately I'd gotten a bit out of the podcast-listening habit, since I was carpooling with some...

John Hedtke on Disaster Preparedness and Book Publishing

Listen here: The Complete Idiot's Guide to Disaster Preparedness is John Hedtke's latest book—the 26th book he's written. In it, Hedtke explains that although most people think disasters are only major catastrophes, such as earthquakes, tornadoes, or floods, actually a disaster occurs whenever your needs exceed your resources and your ability to respond, and the normal processes of your life are disrupted. In this interv...

Starting Points with Quick Reference Guides: Gathering Before Designing

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" ...