Working in technology, I spend a good amount of my time troubleshooting. When things go wrong, I've learned a few tips and techniques:
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?
Get new posts delivered straight to your inbox.
I'm a technical writer based in the California San Francisco Bay area. Topics I write about on this blog include the following technical communication topics: Swagger, agile, trends, learning, plain language, quick reference guides, tech comm careers, and certificate programs. I'm interested in information design, API documentation, visual communication, information architecture and findability, and more. If you're a professional or aspiring technical writer, be sure to subscribe to email updates using the form above. You can learn more about me here. You can also contact me with questions.