CIDM Matters

Paula Manley, Waters
December 1, 2021

Prior to my life as a technical writer, I worked as a scientist. After studying Environmental science at university, I then worked for a company involved in clinical trials for drugs (treating various cancers, Parkinson’s disease, and other disorders). I fell into technical writing when I came to work for a company that creates scientific monitoring equipment. My department creates the user content for customers and engineers for those products.

As a scientific company, my employer is actively involved in STEM outreach — working to encourage the next generation to study and work in the fields of Science Technology, Engineering, and Mathematics. I play an active role myself in that initiative, and I find many parallels between STEM outreach and creating content for users. […]

Géraldine Boulez
November 15, 2021 

Fluid Topics turns your technical content into engaging user experiences.

The technical documentation every company owns is a major reserve of business opportunity. From user enablement and product adoption to customer success, product content has the power to achieve the most critical company goals.

As the leading Content Delivery Platform for technical documentation, Fluid Topics transforms your existing content into compelling content experiences that effectively engage users and enhance operational efficiency. From software and electronics companies to hardware and equipment manufacturers, Fluid Topics supports tech organizations around the world in optimizing their content operations and making the most out of their tech doc. […]

Kathy Madison, Comtech Services
November 1, 2021

Whenever I hear the word “change” or “change management,” I always think of David Bowie’s iconic song Changes. I’m not a huge fan of his music, but once you hear the melody of this song, it will stick in your head forever!

Ch-ch-ch-ch-Changes, (Turn and face the stranger), Ch-ch-Changes,

If only sticking or adopting change at work was that easy. During one of our CIDM managers’ roundtable sessions, folks shared some of their best practices for adopting a change.

[…]

Bonnie Robinson, The OpenNMS Group
November 1, 2021

The OpenNMS Group, a wholly-owned subsidiary of NantHealth, is an open-source company that maintains the OpenNMS project, an open-source network monitoring platform. With an agile development environment, we take a “docs as code” approach, where, among other things, documentation builds integrate with those of the software. […]

Veronica Beck and Robert Perry, Salesforce.org
October 1, 2021

When technology is used for good, it can change the world. It can be one of the most powerful equalizers of our time, providing access to data, knowledge, and connections. Technology can also create barriers. When documentation is hard to understand, it can make intimidating technology even more frustrating. So how can we make our technical documentation accessible, approachable, and friendly? How do we ensure our documentation creates bridges rather than walls? […]

Suyog Ketkar, Autodesk
October 1, 2021

Of the many recent challenges I have faced and accomplished, one has had me tackle relatively more hurdles and obstacles. I have realized, facing challenges is proof that you are on the ‘write’ track — pun intended. One such challenge was delivering documentation to internal customers — also the subject-matter experts (SMEs) for the project. Here’s what I’ve learned: […]

Sean Watson, ServiceNow
September 15, 2021

It’s a daunting task to create a style guide. Style guides contain grammar standards, voice and tone guidelines, words to use and avoid, copy patterns, and the basics of your product brand. These documents can easily end up being so tedious that they’re difficult to use, or so light that they don’t address needs. They can also become outdated quickly, rendering them irrelevant. Here are some ideas to create a successful style guide. […]

Helene Segura, The Time Management Fixer
September 1, 2021

Productivity hacks and time management hacks are popular search terms on Google. Productivity and time management are topics that millions of people are interested in because they want to know how to be more effective and efficient with their time. Is there a better way to work? Is there a way to do more in less time? Is there a way to stop working around the clock? Do productivity hacks actually work? I get asked those questions all of the time because the go-getters I work with want to accomplish more, but they also want to have a life outside of work. […]

Tim Ludwig
September 1, 2021

You may remember us as easyDITA, but we’re Heretto now. Here’s the how, why, and what of that change.

The original mission of easyDITA was to harness the power of structured content to improve technical communication. Years down the road, we did that.

But, why stop there?

As stewards of structured content, we’ve been called to make an impact beyond just technical communication. Our mission is expanded now, grown up a bit to encompass all knowledge content. […]

Sairam Venugopalan, Qualcomm
August 1, 2021

Janaka had a technical degree to proudly hoot,
With erudite English acumen to boldly boot.
Even if it be that his semantic skills had no aberration,
They’d only been garnered as a medium of instruction.
This profile in the job jungle just shone brighter,
For him to don the hat of a technical content writer. […]