Author: Will Kelly

Will Kelly is a technical writer living and working in the Washington, DC area. After years of contracting, he returned to full-time corporate job in 2016. He writes thought leadership content around cloud, enterprise mobility, and cybersecurity topics. Will's has written for Samsung Business Insights, Tom's IT Pro, TechBeacon, CNET TechRepublic, and other sites. Earlier in his career, he wrote technical documentation for end users, developers, and operations teams. His current areas of interest include multi-cloud solutions, mobile security, and managed services. Follow Will on Twitter: @willkelly.

4 reasons why your document reviews aren’t working

kelly-brito-256889
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 technical reviews are integral parts of the technical publications process. Unfortunately, so many organizations fumble through the review cycle.

Continue reading 4 reasons why your document reviews aren’t working

The 7 deadly sins of project leadership

fabian-blank-67318

Project team leadership is an even more important skill in today’s tight economic times making it even more of a shame when new, and even some experienced project leads fumble the ball in the name of their muddled agendas.

While doing more with less is quite a mantra these days, there are seven deadly sins of project leadership holding back once successful project teams from continuing to thrive.

Continue reading The 7 deadly sins of project leadership

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

fab-lentz-253417

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 recover from quickly.

Writing projects can fail or stall for a myriad of reasons including poor planning, course changes in the project plan, and other risks that may or not be accounted for in the overall project plan.

Here are five ways to get past a failed or stalled writing project:

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

6 ways to sabotage your technical documentation

markus-spiske-148030
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 I was a contract technical writer and now that I have a staff technical writer job.
 
Developing technical documentation isn’t fun. Otherwise, it wouldn’t be such an afterthought. Things aren’t made any easier with a technical writing profession that is fragmented on the actual role of the technical writer.
 
Here are some ways organizations sabotage their technical documentation:
 

Continue reading 6 ways to sabotage your technical documentation

5 reasons screencasts annoy me

juliette-leufke-154599

eLearning and screencasts, in particular, seem to be all the rage to the point they are even replacing online documentation for some technology vendors. This development raises my Irish a bit because I never think buzzwords and fads should substitute for real support documentation.

While screen casts are great to augment online documentation and customer support sites

Here are 5 reasons screencasts annoy me.

Continue reading 5 reasons screencasts annoy me

A few words about Microsoft Word and Track Changes

Review toolbar

One of the most useful – yet potentially embarrassing – features of Microsoft Word is Track Changes. Using the Track Changes feature lets you electronically markup your Word documents with edits, additions, and revisions. Think of it as an electronic red pen so to speak.

The potential embarrassment of the feature comes in when you don’t accept the Track Changes. Comments, edits, and revisions not fit for public consumption can leak out. Even if none of the comments are critical, it is just plain sloppy to have a recipient open up a document that still contains markups.

Continue reading A few words about Microsoft Word and Track Changes

Part-time freelancing: An alternative perspective

andrew-neel-117763

So much is written about the part-time writer or freelancer being the one who complicates part-time working arrangements – they do this, they do that, part-time freelancing during your off hours is going to melt your brain and turn you into a hermit and so forth. These articles only tell half the story and actually do a disservice to writers and potential clients.

Continue reading Part-time freelancing: An alternative perspective