Lessons learned from working as a computer book industry technical reviewer

I was a computer book technical reviewer earlier in my career. It was a freelance gig, but I still consider the work one of the more formative chapters in my professional writing career even though it wasn’t writing work. Computer book technical reviewers sometimes called technical editors are responsible for ensuring the technical accuracy of… Continue reading Lessons learned from working as a computer book industry technical reviewer

The gentle art of project documentation control

Managing project documents can be an underappreciated art in some organizations. It’s an area where a technical writer should take charge. I’ve seen document control of all stripes throughout my career. Document control that works. Document control that didn’t work. Even document control that caused a near staff rebellion. I’ve even seen no formal document… Continue reading The gentle art of project documentation control

4 reasons why your document reviews aren’t working

I’ve long been a student of technical document reviews. So much so, I worked as a technical reviewer for some computer book publishers to learn more about this critical element of the technical communications. Back then I thought I could do a better job than the reviewers where I was working at the time). Editorial and… Continue reading 4 reasons why your document reviews aren’t working

5 ways teams can recover from a failed or stalled writing project

It’s never fun watching a technical documentation, training development, or other writing projects get off to a false start or just downright fail. It can be a real morale blow and expose the writer(s) and their team to criticism from stakeholders. However, failures do happen, and it is best to do what you can to… Continue reading 5 ways teams can recover from a failed or stalled writing project

6 ways to sabotage your technical documentation

Every job hunt and even unsolicited discussions with recruiters during the past few years brought me more tales of organizations continuing to have issues producing and maintaining technical documentation. It is not isolated in one sector, and I keep hearing the same problems repeatedly. This has been a real disappointment for me over the years… Continue reading 6 ways to sabotage your technical documentation