2008 archives

  1. Quick Reference Guide Formats -- Tips for Finding Attractive Layouts

  2. Generational tech guilt?

  3. WordPress Tip: Integrate WordPress into an Existing Website

  4. A Tech Writer's World: A Killer Manual

  5. Podcast: Technical Writing in Agile Environments -- Interview with Alyssa Fox

  6. Documentation Honesty and Poor User Interfaces -- An Ethical Dilemma?

  7. What I See -- James Hall's Essays and Florida

  8. The Podfading Roller Coaster

  9. Podcast: What Is the Technical Writer's Role in Interface Design? Interview with Bogo Vatovec

  10. WordPress 2.7 Released - XML-RPC and AtomPub Changes || Joseph Scott

  11. When Trust Becomes a Characteristic Flaw in a Project

  12. Twitter Hashtags and Virtual Gatherings

  13. Generations Change, But Help Formats Remain the Same?

  14. Helpful Little Tips for Life

  15. Writers See Stories Where Others Don't

  16. Twitter Part II –- One Step Deeper

  17. The Name of Your Department Does Matter

  18. Does Twitter Fit into Your Branding Strategy?

  19. Top 10 Gag Christmas Gifts for Technical Writers

  20. Guy Kawasaki's Alltop Site Now Includes Technical Writing

  21. Snippets Toward a Philosophy of Life

  22. The Problem with Speaking Conversationally in Video Tutorials

  23. What Constitutes "Intelligent Content"? Interview with Ann Rockley

  24. Transitioning from Literary Studies to Technical Communication

  25. User Assistance: Will Write for Metamucil

  26. My Tip for Productivity: Tear Up the To-Do List

  27. Usability Newsletter Interview – I'd Rather Be Writing – The Man Behind the Words

  28. Does Design Matter in Comparison to Content?

  29. Finding a Conversational Voice in Video Tutorials

  30. Details About the STC Summit Recording -- Interview with Lloyd Tucker

  31. Dawn or Dusk -- Considering the Advantages of Early Morning

  32. You Can Now Advertise on My Blog

  33. Author-it Launches a Blog -- An Interview About the Who, Why, and How

  34. 'Lost the Fire – How to Rekindle It' – A Second Response

  35. Guest Post: Tech Writing Careers -- The Raw, Unvarnished Truth

  36. Podcast: Debunking the Boredom Myth of Technical Writing

  37. Guest Post: Real Writers in Virtual Worlds

  38. Podcast: Personalities of Technical Communicators -- Interview with Deborah (Shapiro) Hemstreet

  39. Two-Minute Video to Convince Others of the Value of Technical Documentation

  40. Interview with Scott Abel, Conference Organizer Extraordinaire

  41. 10/23 Intermountain STC Meeting: An Informal Discussion of Any Tech Comm Challenges You're Facing

  42. Seamlessly Integrating a Blog into Your Non-Blog Website

  43. Caught in the Current of Writer River: Building and Participating in Community-Driven Websites

  44. 10 Ways to Gather Feedback from Users

  45. What We Learn from Help Authoring Tool Surveys

  46. Like Father, Like Daughter

  47. Becoming a Writer -- Reflections on a Trip to Idaho

  48. Results for My 10 Technical Writing Stereotypes Survey

  49. Answering Reader's Questions: 'My Desire to Write Burns in My Heart Daily'

  50. HelpScribe: Why software is the best technical writing field

  51. Ingenious Technique for Helping Your Child Learn to Ride a Bike

  52. Free Ticket to DITA Tech/Comm Conference in North Carolina Nov 3-6

  53. Ten Technical Writing Stereotypes

  54. WordPress Tip: Using WordPress as a CMS -- Wordcamp Utah

  55. SEO Tips for Your Blog -- Wordcamp Utah

  56. WordPress Tip: WordPress and Podcasting — Wordcamp Utah

  57. WordPress Tip: WordPress 2.7 and Beyond – Keynote by Matt Mullenweg at Wordcamp Utah 2008

  58. Free Doc Train East Ticket

  59. Leaning Towards Longer Topics and Shorter TOCs

  60. Podcast: Repurposing Content for Multichannel Publishing (Single Sourcing)

  61. Users Read Help Manuals Like an Encyclopedia, Not a Novel

  62. Tip: Search Engine Optimize Your Blog Posts to Increase Your Readership

  63. WordPress Tip: Limau-Orange Theme with Navigation Bar from Contempt

  64. STC-Intermountain Meeting Tonight

  65. Watch What Happens When You Copy from Word into a Blog Post

  66. Thinking About an STC Proposal to Submit

  67. What's Convenient Gets Used -- a General Principle That Applies to Nearly Everything

  68. Wordcamp Utah -- Sept 27 in Provo, Utah

  69. How I Create Video Tutorials

  70. Prove My Help Authoring Tools Survey Wrong

  71. Help Authoring Tool Survey: Who, What, and How

  72. How Much Should You Document? Everything? Strategies for an Agile Environment

  73. Podcast: Flare 4 -- Ten New Features, Interview with Sharon Burton

  74. FLOSSmanuals.net: A New Wiki Help Authoring/Publishing Tool Hybrid

  75. Podcast: What's New in the Field of Technical Communication?

  76. Why I Hate Camping -- And Then an Epiphany

  77. Flare 4 Giveway — Enter to Win a Free Copy by Commenting on This Post | I'd Rather Be Writing - Tom Johnson

  78. Explain what you feel is an important feature for a help authoring tool and why (Flare Giveaway)

  79. Everything That Happened Today, or, The Busy Lives We Lead

  80. Utah Technical Writers Group -- Finding the Technical Writing Community in Utah

  81. Resources for Single Sourcing Projects

  82. Comprehensive Podcast Index -- A List of All My Podcasts

  83. On Podcasts -- Reasons for the Break and Plans for the Future

  84. WordPress Tip: WordPress as a Dr. Jekyll and Mr. Hyde Application

  85. Corporate Migration to the Blogosphere

  86. Another Collaborative Site: Read Scriptures Together

  87. How to Listen to Podcasts

  88. Too Connected – Utopias and Dystopias of Communication

  89. With All This Fuss About Tools, Three Best Practice Attitudes

  90. User Assistance: Why I Hate PDFs

  91. WordCamp Utah Registration Is Now Open - Joseph Scott's Blog

  92. Word Macro for Resizing Images that Have a Specific Style

  93. Tapping your creative juices Interesting ...

  94. An Article That Changed My Approach to Help

  95. Instructional Text in the User Interface: Some Counterintuitive Implications of User Behaviors :: UXmatters

  96. Free PDF Alternatives -- Save Yourself $700 and a Headache

  97. A History of Tech Comm Tools. This is a ...

  98. Echoes from the past: DITA, Help, Single-Sourcing tools -- Looking from the 60s to today

  99. Get Training in Technical Writing

  100. A Career in Technical Writing: End of Part One : PoeWar.com Writer's Resource Center

  101. Thank You Silahsiz Kuvvetler for Showing Me the Light

  102. Personal Essays on a Technical Writing Career -- by John Hewitt

  103. The Myth of Simplicity and Complexity in Help Authoring

  104. WordPress Tip: Show the Latest Post in Full, Then Summaries of the Other Posts

  105. WordPress Tip: WordPress' Biggest Mistake

  106. Reader Question: Creating Online Help for Touch-Screen Applications?

  107. New Site Policy About How I Respond to Questions

  108. Organizing Large Photo Collections Online -- Use the NextGen Gallery WordPress Plugin

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

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

  111. Venn Diagram of What a Blog Should Be About

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

  113. WordPress Training This Saturday 9 am to Noon

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

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

  116. Quick Reference Guides: The Poetry of Technical Writing

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

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

  119. Interview with Me in TechCraft

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

  121. 14 Widespread Myths about Technical Writing

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

  123. My WordPress Site Was Hacked

  124. Customizing Your SharePoint Site? Read These 10 Concepts/Gotchas First

  125. Podcast: Five Books to Add to Your Technical Communication Library

  126. The Kind of Documentation Users Really Want

  127. "How can I become a successful TECHNICAL WRITER?"

  128. Systems that Get Better the More People Use Them

  129. Announcing WriterRiver.com, a Digg-like Social News Site for Technical Communicators

  130. Technical Writer as Conversation Stopper, and Other Notes from the STC Summit in Philadelphia

  131. My First Guest Post -- And Best Writing Tip

  132. Playing with Sound -- Adding Downbeat Tempo to a Discourse on Shakespeare

  133. Follow the STC Conference Twitterers at http://twemes.com/stc2008

  134. Marketing Yourself and Your Experience to Others in a Web 2.0 World

  135. Podcast: Using Video in Training and Documentation, Interview with Todd O'Neill

  136. Podcast: Analyzing Your Users and Needs Before Creating the Help Deliverables; Interview with Nicky Bleiel

  137. My STC Summit Presentation and Panel -- "The Art of the Podcast" and Marketing Yourself in a Web 2.0 World

  138. Podcast: How to Create User-Centered Documentation, Interview with Joe Sokohl

  139. Exploring Web 2.0 Possibilities in a SharePoint-Endorsed Environment

  140. Integrating All Library Content into One

  141. Thinking About a More Personal Style of Podcasting

  142. Podcast: Workspaces, Collaboration, and Information Sharing -- Interview with Emma Hamer

  143. Podcast: Why Content Management Projects Fail, Interview with Rahel Bailie

  144. Podcast: How XML Enables Information Sharing and Reuse -- Interview with Joe Gollner

  145. Feedback on the Podcast From a German Listener

  146. Poewar Giving Away $250 to the Guest Blogger Who Brings in the Most Traffic

  147. Scott Nesbitt Interview with Stewart Mader on Wikis

  148. Musings of a Tech Writer Podcast -- Mark in Canada Reflects on The Content Wrangler Versus the STC

  149. Podcast: XSL, Flash, and Live Blogging -- Interview with Sarah O'Keefe

  150. Podcast: Document Engineering, Interview with Robert Glushko

  151. SharePoint Wikis: Both Liberating and Frustrating

  152. Giving a Virtual Presentation to STC-Phoenix on Tuesday, May 13

  153. Post Doc-Train Thoughts While Sitting in the Vancouver Airport

  154. Podcast: Living Multiple Lives -- The New Technical Communicator, Interview with Noz Urbina

  155. Podcast: Embracing Wikis -- Interview with Stewart Mader

  156. Changing the Rules of the Game for the Benefit of the User

  157. Social Media 101: Now Everyone's a Technical Writer

  158. Podcast: Moving 50,000 Pages of Unstructured Content to DITA

  159. The 10/20/30 Rule of PowerPoint That I Wish Everyone Followed

  160. Podcast: Leading Your Company into the Wikis, Blogs, and Social Networks of Web 2.0

  161. WordPress Tip: Using WordPress to Build Websites Instead of Blogs

  162. WordPress Tip: My WordPress Quick Start Guide — Now Available on the WordPress Codex

  163. WordPress for Beginners Course

  164. The Broken STC Model -- and What's Replacing It

  165. Updated Date and Time for WordPress Course -- Wednesday Evening, April 30

  166. Madcap Blaze's Topic Review Feature: A First-of-a Kind Feature with an Interesting Workflow

  167. Podcast -- DITA: From the Perspective of Someone Actually Using It

  168. WordPress for Beginners Course -- Wednesday Evening, April 30

  169. Why Software Applications Need Product Blogs, and Why They Don't Get Them

  170. How Much Time Do You Spend in Web 2.0 -- Interesting Article from the Read/Write Web

  171. Find a Way to Have Fun in Your Writing

  172. Looking for Corporate Examples of Web 2.0 Engagement

  173. Podcast -- Social Networking and the Value of User Communities for Technical Communicators

  174. Guest Post -- From Blogging Veterans: Three Keys to Successful Blogging

  175. The Right Way and Wrong Way to Teach People WordPress: Notes from a Wordcamp Utah Planning Meeting at Applebees

  176. Podcaster Meetup at Doc Train West Conference in Vancouver

  177. Technical Writing -- Worth it? Interesting? Creative? Well-Paid? Hours? Answering a Few Questions from Saudi Arabia

  178. Keep an Open Mind: Detention Without Amanda Jones Isn't Necessarily Bad

  179. NY Times Article Suggests Effects of Blogging = Weight Loss/Gain, Sleep Disorder, Exhaustion, Heart Disease, and Nervous Breakdown

  180. How to Get Your Blog Mentioned in the Society for Technical Communication's Intercom: Include the Word "Technical Communicator"

  181. A Recipe for More Engaging Software Demos

  182. Podcast -- Transitioning from Technical Writing into Usability

  183. My Podcast in iTunes -- The iTunes Gods Have Granted Me Mercy

  184. The Question No One Asked Me at the Career Advice Panel, Thank Goodness

  185. The Best and Worst of Times with a Hard Headed Woman

  186. Twitter Tools and Uses: The Most Comprehensive Listing of Twitter Resources I've Seen

  187. A Creepy Widget I Absolutely Had to Add to My Blog

  188. I Enjoy a Good Alien Podcast Now and Then

  189. How to Get Everyone and Their Dog/Family/Friends Reading and Subscribing to Your Blog -- 10 Tips

  190. What's the Best Thing You've Done to Grow Your Career?

  191. I'm Planning to Offer WordPress Training -- Are You Interested?

  192. Four Simple Ways to Avoid Totally Botching an Interview

  193. Podcast -- Tackling Godzilla: A Writer/Usability Consultant Reflects on the Largest Project of her Career

  194. Virtual Meetings: A Lofty Yet Impractical and Unwanted Ideal? or Exactly What We Need?

  195. Seven Reasons Why I'm Twittering -- Especially During Conference Time

  196. Are You One of the 824 Technical Communicators on Ning Yet?

  197. Uncooperative Subjects: A Comparison of Two Failed Interviews and How to Turn Them Around

  198. Body Hacks and Optimization

  199. 10 Alternate Tests for Evaluating Technical Writing Job Candidates -- A List for Hiring Managers

  200. Six Ways I'm Using the H4 Zoom Recorder to Do Technical-Writing Related Things

  201. Lots of 2008 SXSW Podcasts Now Available

  202. My 5 Pet Peeves with Reading Blogs (mostly surrounding comments and feeds)

  203. Deciding When to Speak Up and When to Shut Up

  204. Two Types of Posts in the Blogosphere: Knowledge Posts and Creative Posts

  205. Recording SME Demos -- It's Easier Than You Think

  206. How to Record Live Presentations with the Zoom H4 Digital Recorder

  207. My Blogging and Podcasting Presentation -- the MP3 and Video Recording

  208. Stoking the Creative Muse: How Finding Ideas to Write About Is Similar to Remembering Your Dreams

  209. How My BlackBerry May Benefit You

  210. A blogging family

  211. Eight stitches for Susan

  212. CNN Producer Fired for His Blog -- A Growing Discontent for Mainstream Media

  213. 10 Ways to Bomb Your Presentation

  214. My Love Affair with Drop-Down Hotspots Ends

  215. Have a Blog? a Podcast? Want one? Come learn everything you need to know

  216. Why You Should Send Me (and Other Bloggers) Your Products for Free

  217. A Glimpse into the World of Agile Technical Writing, a.k.a. Extreme Technical Writing (XTW)

  218. Welcoming Camtasia Studio as a New Blog Sponsor

  219. Two New Blogs to Add to Your Reader: Craig Haiss' Helpscribe and Sharon Burton's Madcap Blog

  220. "Selection Beats Damping": A Compelling Argument About Why Blogs Trump Print Media

  221. Technical Writing Careers -- Answering 13 Questions about Technical Writing Jobs

  222. Top 10 Workspace Configurations for Technical Writers

  223. Free Doc Train Ticket ($899) for Your Response to a Question About Innovation

  224. Survey Results: How I'm Changing My Blog Based on Your Responses

  225. Jing Screencast: Getting Up and Running with Jing

  226. Are Gerunds in Topic Titles Problematic in Search Results?

  227. How Jing Can Benefit Technical Writers

  228. Will you take my short survey?

  229. Answering Questions on the "Practicalities of Blogging"

  230. A Web 2.0 Documentation Idea Gone Wrong

  231. I wish all companies provided tech support like this

  232. Blogger Compiles Extensive Examples of Unnecessary Quotation Marks

  233. Interview with STC President Linda Oestreich: Directions the STC Is Heading

  234. Notes from My First WordPress Meetup

  235. Camtasia Versus Captivate: Thinking About Screen Real Estate Problems in Video Captures

  236. Madcap Flare Review: 45 Things I Love About Flare, 31 Things I Hate About It

  237. 2008 WritersUA Salary Survey Published: $76K Is Average

  238. Going Beyond Technical Writing: Practical Advice for Diversifying Your Skillset -- Podcast Interview with Mark Hanigan

  239. Blogging Jobs for Technical How-to Articles

  240. PodcastFAQs.com: A New Information Resource for Podcasters

  241. President Hinckley Passes

  242. Clearplay: An Ingenious DVD Player That Filters Movies Without Altering Them

  243. WordPress Meetup in Salt Lake City with Matt Mullenweg

  244. Upcoming PodCamp in Salt Lake City on March 15

  245. The Art of Interviewing — 10 Tips for Perfecting the Most Important Element of Podcasting

  246. Innovation in Technology -- During Research, Unexpected Findings Lead You Down New Paths

  247. All About Madcap Flare: Podcast Interview with Paul Pehrson, MVP in Madcap Software Forums

  248. How to Share Everything with Everyone (well, a few things anyway)

  249. How to Get Out of a Slump, and Handle Pressure Situations Calmly

  250. The Impact of Social Media on Technical Communication -- Podcast Interview with Bill Albing

  251. "Regular Sloggers Trying to Make a Living"

  252. Three Notable Characteristics of Top 10 Posts: Lists, Headings, Images

  253. Why Some Leaders Don't Blog: The Untold Story

  254. The #1 Reason Why People Fail at Their Goals

About Tom Johnson

Tom Johnson

I'm an API technical writer based in the Seattle area. On this blog, I write about topics related to technical writing and communication — such as software documentation, API documentation, AI, information architecture, content strategy, writing processes, plain language, tech comm careers, and more. Check out my API documentation course if you're looking for more info about documenting APIs. Or see my posts on AI and AI course section for more on the latest in AI and tech comm.

If you're a technical writer and want to keep on top of the latest trends in the tech comm, be sure to subscribe to email updates below. You can also learn more about me or contact me. Finally, note that the opinions I express on my blog are my own points of view, not that of my employer.