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
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
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
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
While covering project management and collaboration topics for CNET TechRepublic, I had the opportunity to write about Asana, a social task management platform. I liked it so much I started using to manage the editorial checklists I create for articles, blog posts, and corporate client projects.
When it comes to project teams, Asana is a viable substitute for email. I even recommend Asana to freelancers and independents who need to centralize their project task management.
Continue reading Using Asana for managing personal projects
Technology pundits, consultants, and academics often see the latest online technologies, millennials, and work/life Balance are what drives online collaboration. It takes more than just one of those trends to drive collaboration. It’s about the total culture of so I’ve found during my time as a contract technical writer.
Corporate culture has to promote online collaboration for it to be successful. Culture gives employees space and tools for success to collaborate with their coworkers, contractors, and external customers.
Some integral elements of a collaborative corporate culture include:
Continue reading Creating the collaborative corporate culture
powers the email behind willkelly.com
. I’ve also written about Google Apps off and on for a while.
Along the way, I’ve started using Google Sites to capture professional information that I want to keep in the cloud but Evernote didn’t seem like the right tool.
Continue reading 4 ways I use Google Sites