Ambiguity should signal ownership for technical writers

Too many technical writers live in style guides, single sourcing, FrameMaker, processes, and methodologies. They can sometimes escape from the business of software development. This monk like college advanced composition teacher existence can separate the technical writer from the realities of today’s dysfunctional workplace.When facing down ambiguity, technical writers have two choices: Wallow in the… Continue reading Ambiguity should signal ownership for technical writers

Why I left contract technical writing

I spent a large part of my technical writing career working as a contractor. It was a formative part of my career where I got to focus on doing the work and got experience working in such industries as telecommunications, financial services, and even worked in an NGO. I’d work on a 1099 or W2… Continue reading Why I left contract technical writing

Some of my content development goals for 2019

As 2018 comes to a close, I’ve begun to start thinking about some content goals for the next year. My intent has always been to have the right mix of personal and professional writing projects to keep me busy. While my day job has been quite demanding the past few months, my freelance writing projects… Continue reading Some of my content development goals for 2019

The technical writer’s 5 best friends

Technical writers need to expand their personal and professional friends because they need to. Building a strong personal and professional network 1. The product manager The product manager can be the technical writer’s best friend or worst enemy. Knowing a competent product manager can aid technical writers to better understand the product they are documenting. On the dark side,… Continue reading The technical writer’s 5 best friends

Installing Drupal: Lessons Learned

Here are some lessons I learned a few years back when I was installing Drupal for the first time.  It was a rather mixed experience.  I tore it all down the other weekend and started over, not as much out of disappointment, but to knock the kinks out of my first deployment. Here are some… Continue reading Installing Drupal: Lessons Learned

A technical writer’s guide to NDAs

I was cleaning out my home office recently and came across a collection of Non-Disclosure (NDA) Agreements that I’ve signed over the years as a technical writer. A quick leaf through of the folder made it clear that many of the NDAs were much the same if not identical. As a tech industry contractor or… Continue reading A technical writer’s guide to NDAs