Thoughts on Troubleshooting and Problem Solving
January 19th, 2009 | Posted in blog 5 Comments »
Working in technology, I spend a good amount of my time troubleshooting. When things go wrong, I’ve learned a few tips and techniques:
- Compare line by line against a working model
- List all the components and how they work together
- Challenge every assumption
- Reboot or reinstall
- Google the error messages you see
- Site-search key sites
- Come back to it later
- Contact an expert
- Post the question in a forum
- Send the problem across Twitter
As today was MLK day and I had work off, I had a chance to dive into some WordPress projects on my to-do list. In prioritizing projects, I realized what I find so addictive about WordPress: the troubleshooting. When a project is easy, I find it boring. The challenges are what draw me. So I start with the most difficult first.
With WordPress problems, errors follow recurring patterns. If the alignment is completely wonky, it’s usually a div tag problem. If you receive sudden fatal errors that break the display, start deactivating plugins one by one. Is your cursor acting funny? Clear your browser’s cache or upgrade to the latest version of WordPress. Is there a problem with links not connecting to posts or pages? Check out the .htaccess file. If it’s a CSS problem, e.g., can’t figure out the style, and viewing the source code doesn’t work, I sometimes perform CSS brain surgery, chopping large parts of CSS code displayed with the Firefox CSS Web Developer extension until I find the controlling style.
I also find it fulfilling to solve other people’s problems, even if they’re easy. For example, a client called explaining a need to include a LinkedIn-Share-This type button below the post. I did some digging (on a LinkedIn network) to find the right plugin, and then implemented the plugin on the phone with the client. That was pretty cool.
In fact, I changed my WordPress training model to specifically address problems people are having (rather than giving them a generic WordPress how-to). Most people reach out to me after they bang their heads in vain a few days. They don’t want general information — they want to fix their problems.
In writing about troubleshooting, I don’t want to present myself as one without any technical problems. Like most people, I have a list of problems that I can’t quite seem to conquer. But that’s all right — it gives me a puzzle to solve, and the puzzles engage me.
Do you have any troubleshooting tips of techniques that work well for you? Or, for the WordPress users out there, what’s the most challenging problem you’ve faced, and how did you overcome it?
Sponsors
Tags: analysis, consulting, problem solving, Technical Writing, troubleshooting, WordPress
If you liked this post, keep updated with new content: Subscribe to I'd Rather Be Writing.
Both comments and pings are currently closed.


















Firebug web extension is a better alternative which lets you view css hierarchically. It lets you see which css styles have been overridden. Totally cool.
BTW, I really enjoyed your two posts about adapting static sites to wordpress sites. I plan to consult it in the next two weeks for a project I’m working on.
Thanks for the recommendation, Robert.
Re adapting static sites to wordpress sites, I have tried to change my method for doing this somewhat. The skill is to not bring over any tables at all in doing. You can see a successful example at http://alternative-energy-nation.com and http://alternative-energy-nation.com/blog. However, the current project I’m working on has a complicated navigation menu that I can’t replicate, so I copied it over. Tables are poor for SEO, which is what everyone wants. Still, seamlessness without tables can be tough.
Robert,
Thanks for opening my eyes to Firebug. I feel dumb for having used the Web Developer extension for so long. This morning I was playing around with Firebug and it is about a hundred times more useful. Thanks again,
Tom
Here are a few techniques I use regularly.
Ask another writer to test the technology in case the errors are specific to my computer, environment settings, and so on.
Use alerts to debug scripts.
Search the help for troubleshooting tips. (I’m a bit biased toward this solution.)
Create log files, and scan them for clues about the problem.
When these techniques fail, I refill my coffee cup and ponder the problem until the obvious solution hits me.
Great post, Tom!
Craig Haisss last blog post..How help search should work
What I usually do is:
Google the error messages, ask in a major forum, and if that fails, Come back to it later.
The “fresh eyes” approach normally works, though.
p1nk g33ks last blog post..Why you should get out of that traffic exchange or link exchange program ASAP!