We had a couple of writing interns join our group this month. To track writing assignments for the technology blog, I’ve been using JIRA. JIRA is a bug tracking tool from Atlassian (the same company that makes Confluence). It’s typically used by software teams to track bugs during software development projects. You can add comments to items, assign items to team members, assign the items … more »

When I read books to my little girls (ages 5 and 7), the pictures combined with story provide a captivating experience. I’ve often thought that if I wanted to create documentation that people actually read, maybe I should integrate these two same elements: picture and story. I’m not entirely sure what a product would look like that integrates these two elements, because technical writing usually … more »

A Practical Guide to Designing with Data (Five Simple Steps, 2010), by Brian Suda, is a thorough exploration of best practices for graphs and charts. It’s somewhat similar to Edward Tufte’s Visualizing Information in focus, and both have a shared antipathy toward “chart junk” in the effort to tell the story of data. Suda explains, The main purpose of this book is to encourage you … more »

After my Summit presentation about breaking out of topic-based hierarchies, a lady named Ursula came up to me and said she was tired of topic-based authoring. I asked her what the alternative was. She said she’s often more interested in seeing an end-to-end process rather than a specific task. This reminded me of a tutorial on Lynda.com in which Deke McClelland, the trainer, showed how … more »

I’ve been thinking lately about my brand. I’ve always hated this marketing term, but the word “brand” does help answer a question. When you think of me, what comes to your mind? I’ve written about a lot of different topics on this blog, everything from findability to podcasting, blogging, technical writing, flare, wikis, screencasts, project managers, content organization, and more. My content is diverse enough … more »

[Audio clip: view full post to listen] Download MP3 Length: 70 min. In the barrage of information created by all the social media channels, how can you find relevant content? How can you move past forms of noise to actually produce content that engages users? What forms of social media do students respond to the most? These are some of the questions we explored in … more »

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 ask a question, she asked if anyone had seen our … more »

With my ongoing series on organizing content, I left off at the question of whether blog platforms would outperform help authoring tools as a way to organize content for web environments. I had a lot of thoughts about that topic, and actually created a blog theme for a documentation project as a test, but recently I received a new project on my plate, and my … more »

My wife Jane attended a Segullah writer’s retreat conference this weekend. During the conference, one of the presenters explained a common mistake many novice writers make: they look for stories to fit a pre-selected theme. You hear the result of this strategy most commonly in church talks. Someone is assigned a topic, or has a topic he or she wants to explore. To make the … more »

Whitney Quesenbery has just published Storytelling for User Experience: Crafting Stories for Better Design. In this interview I ask her to elaborate on the story behind the story, how stories compare with user personas and user stories, and how to gather stories from users. We recorded this videocast at the STC Summit in Dallas.

Story Now I have a confession to make. I really didn’t want to talk about roles and hats and value. I wanted to talk about story. But I didn’t want to talk about story directly. Instead, I wanted to illustrate it by structuring my entire presentation as a story. You’ve seen that with each of the headings, I labeled a component of the story. I … more »

I’ll be in Atlanta next weekend giving a talk (the keynote, actually) at the STC Atlanta Currents conference. You can read more details about the conference here. My presentation is titled “From Overlooked to Center Stage.” Here’s the description: The rate of online information continues to increase dramatically. Both professionals and amateurs in every field are publishing content on blogs, forums, websites, intranets, podcasts, and … more »

Of all the podcasts I listen to, I enjoy This American Life the most. I enjoy it because Ira Glass, the show’s producer, has a keen sense of story. Not story in the sense of fables or fiction (which you can listen to at Storynory or The New Yorker Fiction podcast). Nor single personal narratives that you find with podcasts like The Moth Podcast (which … more »

I decided to record a short two-minute videocast to try out my new Kodak zi8 pocket camcorder. In this videocast, I share a brief thought about the similarity between creative writing and technical writing.

Several weeks ago, I was reading something that caused me to worry. A line in a scriptural narrative biography tells how his father taught him in all the ways of right. As a father, I thought about what I had taught my children, and it wasn’t much. They weren’t going to become Enochs from anything I showed them. Football on Sundays, basketball during the week, … more »