For years I prided myself on single-sourcing both online help and printed guides. When I used RoboHelp, I created custom macros in Word to clean up and adjust the print formatting. With Madcap Flare, I hammered out the print styles until everything looked clean. And then I made a major mistake: I more or less Read more »
Principles for Organizing Print Material [Organizing Content #21]
For years I prided myself on single-sourcing both online help and printed guides. When I used...
Relying on the Wisdom of the Crowds with Help Authoring [Organizing Content #20]
The most compelling idea from emergence, which I explained in my previous post, is the surprising...
Emergence [Organizing Content #19]
In the ongoing series on organizing content, we now shift attention to the phenomenon of emergence,...
Replaceability
About a month ago, I was talking with some of my friends at church when my wife Jane came into the...
Problem Solving and Sprinkler Repair
The other day Jane called and said I should come home because water was bubbling up in the...
Free Copy of Camtasia Studio 7 and Snagit 10
Techsmith gave me a free copy of Camtasia Studio 7 and Snagit 10 to give away on my blog. To enter...
Separating Basic from Advanced Topics: How Twitter Organizes Their Help [Organizing Content #18]
When you click Twitter’s help link, the help content is divided into three categories:...
Latest Blog Posts
-
Principles for Organizing Print Material [Organizing Content #21]
Posted on 30th Jul 2010 17 comments
-
Relying on the Wisdom of the Crowds with Help Authoring [Organizing Content #20]
Posted on 27th Jul 2010 8 commentsThis entry is part 20 of 21 in the series Organizing Content
The most compelling idea from emergence, which I explained in my previous post, is the surprising wisdom of the crowd. The guesses of 800 people about the weight of an ox at the county fair averaged out to be just one pound from the actual ox’s weight. The wisdom-of-the-crowds idea is revolutionary. Traditionally “the masses” Read more »
-
Emergence [Organizing Content #19]
Posted on 20th Jul 2010 8 commentsThis entry is part 19 of 21 in the series Organizing Content
In the ongoing series on organizing content, we now shift attention to the phenomenon of emergence, and how intelligent, sophisticated systems emerge from relatively simple, unsophisticated parts. I listened to a Radiolab podcast the other day that explored this topic in depth. The hosts related how in the 1800s, Francis Galton visited a county fair Read more »
-
Replaceability
Posted on 19th Jul 2010 8 comments
About a month ago, I was talking with some of my friends at church when my wife Jane came into the room crying and asking where Kevin was. I wasn’t sure what happened, but I soon found out. Jane had been substituting in Primary, a class for children. During a game where everyone gets to Read more »
-
Problem Solving and Sprinkler Repair
Posted on 15th Jul 2010 4 comments
The other day Jane called and said I should come home because water was bubbling up in the sprinkler box in the yard. I don’t know anything about sprinkler systems, so with a sense of dread I drove home. Sure enough, the valve box was a puddle of water. I do know how to shut Read more »
-
Free Copy of Camtasia Studio 7 and Snagit 10
Posted on 12th Jul 2010 23 comments
Techsmith gave me a free copy of Camtasia Studio 7 and Snagit 10 to give away on my blog. To enter the contest, just leave a comment on this post. In your comment, tell me something interesting about screencasting. It could be a tip, an argument, a story, a scenario, a technique, or whatever. The Read more »
-
Separating Basic from Advanced Topics: How Twitter Organizes Their Help [Organizing Content #18]
Posted on 8th Jul 2010 2 commentsThis entry is part 18 of 21 in the series Organizing Content
When you click Twitter’s help link, the help content is divided into three categories: Twitter Basics Something’s Not Working Report a Violation This division suggests a mental pattern about how people use help. You have the newbie group. These people are new to Twitter and need a grounding in the basics, such as what an Read more »
-
Do Some Project Managers Suffer from the Dunning-Kruger Effect?
Posted on 7th Jul 2010 7 comments
Errol Morris has a lengthy essay in The New York Times on something known as the Dunning-Kruger Effect. Essentially the effect is that even though something is obviously wrong, a person is incapable of recognizing it. Cornell profesor David Dunning stumbled onto the idea when he read about a bank robber who squirted lemon juice Read more »
-
Does a Technical Writer Need to Understand Web Design?
Posted on 6th Jul 2010 3 comments
A reader asks, Technical writing is a field that I’ve been pursuing and about to complete a certification. My question, how important or valuable would also pursuing a web design certificate for a technical writer? The certificate in web design? Not necessary. But a working knowledge of HTML and CSS? Yes, critical, because everything is Read more »
-
Breaking Things as a Form of Creativity
Posted on 1st Jul 2010 1 comment
IT Author’s latest podcast, Testing testing 123, dives into testing. Rather than just commenting on testing from a technical writer’s point of view, Alistair Christie and his co-host Graham Campbell interviewed an actual tester. It’s a good interview with lots of informational nuggets. For example, “regression testing” is testing those software features that were tested Read more »
WordPress Newsletter
-
WordPress Tip: Integrate Constant Contact with WordPress
Posted on 27th Jul 2010 0 comments
Today’s WordPress tip is on integrating Constant Contact (an email marketing service) with WordPress.
-
Add WordPress 3.0 Navigation System to Your Site
Posted on 12th Jul 2010 1 comment
Before WordPress 3.0, one of the frustrations with WordPress was configuring the navigation menu when you wanted to combine pages, categories, and URLs. The new navigation system in WordPress 3.0 solves this problem, because it allows you to create a menu by dragging and dropping almost any type of link. But just upgrading WordPress to Read more »
-
WordPress Tip: There’s a Plugin for That
Posted on 30th May 2010 2 comments
I sent out this tip in my last WordPress newsletter. You can subscribe to my WordPress newsletter here. One of the many advantages of WordPress over other blog platforms is the number of plugins available. Plugins are scripts that you can add to WordPress to increase the functionality in some way. For example, a contact Read more »
-
WordPress Tip: Backing Up Your Database
Posted on 24th May 2010 1 comment
I sent out this tip in my last WordPress newsletter. You can subscribe to my WordPress newsletter here. With WordPress 3.0 just around the corner, scheduled to be released before the end of the month, what should you do to prepare? When the update is available, you’ll see a notification message at the top of Read more »
-
WordPress Tip: Creating WordPress Themes to Match Existing Sites
Posted on 15th May 2010 0 comments
I sent out this tip in my last WordPress newsletter. You can subscribe to my WordPress newsletter here. I decided to start up a WordPress newsletter to offer weekly tips on WordPress. I added the sign-up widget on my sidebar about a month ago. Since then, 56 people have signed up. I just sent out Read more »
Breaking into Technical Writing
About this Site
Notes
-
The Role of the Gatekeeper
Posted on 28th Jul 2010 2 comments
Sarah O’Keefe’s guest post — The Role of the Gatekeeper is Changing — on Peg Mulligan’s blog is interesting. Sarah writes, The Internet is removing the traditional gatekeepers for content. This may seem obvious, but its implications in my life have been profound. I majored in English and then earned an MFA in creative writing. Read more »
-
Moving into Technical Writing — A DICE Article and More Links
Posted on 22nd Jul 2010 3 comments
How to break into technical writing is one of the most common questions readers ask. (If you wrote a book entirely on this subject, I’m sure you’d sell regular copies.) Recently a journalist interviewed me and others (Jack Molisani, Mike Hughes, and Andrea Ames) on this topic. He published his article, called Use Your IT Experience Read more »
-
WordCamp Utah is August 28
Posted on 22nd Jul 2010 3 comments
Wordcamp is a conference dedicated to topics on WordPress. This year WordCamp Utah will be held Saturday, August 28 at the University of Utah. The conference costs $20 and includes lunch. Here are details from Joseph Scott, the organizer: WordCamp Utah 2010 will be held August 28th at University of Utah, in the Skaggs Biology Read more »
-
Captivate Versus Camtasia Studio
Posted on 18th Jul 2010 7 comments
I’ve been exploring Captivate lately because I wanted to translate some screencasts for a project I’m undertaking. It turns out, Captivate doesn’t work so well for screencasting. Slide-based eLearning, sure. But when you have a lengthy software simulation, it fails because you can’t edit the audio while watching the video play. Really? Yes. Really. You Read more »
-
Message from the Sponsors, July 16
Posted on 16th Jul 2010 0 comments
At least once a month, I post a few messages from the sponsors. Today we have a message from Madcap Software and Techsmith. From Madcap Software Driven by customer demand and request, MadCap Software is pleased to announce MadCap Consulting, a new service aimed to provide our customers with the resources necessary to perform skilled technical Read more »
-
WordPress Webinar July 13 with the STC Consulting and Independent Contracting SIG
Posted on 12th Jul 2010 1 comment
I’m giving a webinar on WordPress tomorrow, July 13, at 1:00 to 2:30 pm EDT. The webinar is organized through the STC Consulting and Independent Contracting Special Interest Group (CIC SIG). Here’s the description: Blogging is no longer a phenomenon. It is a way of life; another layer of communication to understand and utilize. An Read more »
-
24 Hours of Screencasts with Camtasia Studio
Posted on 12th Jul 2010 0 comments
On Tuesday, July 13, TechSmith is create 24 Screencasts About Camtasia in 24 Hours. It must be fun to do screencasts at 3 a.m. If you’re into screencasts (and use Camtasia), these sessions should provide a lot of good information. They’re streaming the screencasts live here and are also recording them to publish later.
-
Showing Youtube Captions by Default in Another Language
Posted on 8th Jul 2010 1 comment
I’ve been researching how to translate screencasts. Here’s one problem to overcome: Even if you use youtube’s caption system, if you embed the translated videos on a web page, will users have to select both their language and captions? Normally, we want the video to display these automatically if we’re embedding the video a page Read more »
-
“Load config.xml failed” message with Notepad++
Posted on 6th Jul 2010 0 comments
Notepad++ is my favorite text editor, but lately it’s been acting a bit berzerk. Every time I open it, NotePad++ says Load Config.xml failed, or something like that. It’s been bugging me for weeks. I finally found the fix here. If you get a load config.xml failed message, take these general steps to fix it: Read more »
-
Save $50 on Registration to Lavacon Conference in San Diego
Posted on 4th Jul 2010 0 comments
If you’re looking for a solid professional development opportunity, check out the Lavacon Conference this year. Held September 29 to October 2 in San Diego, California, the conference focuses on learning how to “publish digital content that enhances the customer experience, reduces production costs and promotes your online brand.” If you read the session descriptions, Read more »












Recent Comments