By Jacquie Samuels
A content management system (CMS) is a handy tool in this new age of structured writing, whether in DITA, S1000D, DocBook, or some freaky, hybrid custom creation. No, it’s more than a “handy tool.” If you’re writing topics, you should have a CMS. It’s that simple.
Take a look at the situations below. If only one applies to you, it’s safe to say you’re just in time to start planning your CMS purchase. If two to four of the situations apply to you, you should be shopping around and getting demos right now. If more than five of the situations apply to you, then you should have purchased a CMS last year.
- Your file server runs out of memory on a daily basis and no one can find files that are not their own, and sometimes you can’t even find your own files.
A file server that contains cryptic folder names (probably based on product names that changed three years ago), a maze of nested subfolders, ten versions of slightly different documentation, hourly snapshots, daily backups—it doesn’t take long to become a tangled mess in less than six months. It takes longer to bake a baby.
If your standard operating procedure upon starting a new version of documentation is to copy and paste the last version of your files and then rename the folder, then you’re not working smart. A CMS lets you snapshot and tag your versions when you’ve released them, then lets you keep on trucking. No copying. No pasting. And then it lets you fix that horrible typo (oh, no, that shouldn’t be “lick the icon”) without ever having to hunt for the old version or worry that you’ve already made three months of updates on the files. Work smarter. Stop copying files. Prevent file server-induced madness. Leave the file server for what it was meant for: pictures of last year’s Halloween costumes.
- The files you worked on yesterday are missing, as though they never existed, making you break out into a cold, nauseous sweat. It’s only 9:00 AM, but it’s time for a drink!
A CMS is, at its core, a database. A database doesn’t lose information. If your manager is the belt-and-suspenders type (i.e., overcautious), then back up the whole database in case of earthquakes and fires and invasions from Mars (we suggest a lunar-based backup in the Mars invasion scenario). But with a CMS, you never need to worry about losing content again.
- You translate to other languages at least some of the time.
Using a CMS to help manage translation workflow can save anywhere from thousands to millions of dollars a year, depending on the number of languages involved. Track source versus translation, keep track of changes that should and should not trickle down through the translation process, control when and what goes to translation, and have it all happen automatically. Don’t use in-house translation? You can also directly connect to translation vendors using the CMS, which means a couple of clicks gets you competitive quotes in your inbox. Easy as pie.
- The thought of finding a particular version of a graphic you made last year makes you laugh uncontrollably. In front of your manager.
A CMS can also be your media library, letting you tag and search for graphics and multimedia. Mind you, the search is only as good as the tagging, so do your prep work on this one.
- When you go on vacation, you have to write out pages of instructions for other writers to take over your project, just in case.
A CMS should be a way of pooling all your resources so that they’re available to everyone who needs them. Yes, you could set up the CMS to only show you your stuff or to break maps and topics out into product-specific collections, but you’re working against yourself and missing the point. Have everything available to all, tag as needed, filter like a master, and you’ll always be able to: 1) find your own stuff, 2) find everyone else’s stuff, and 3) find the stuff that belonged to the guy in the next cubicle who just got fired.
- Despite your best intentions, you have never reused a single topic. Because it is just too difficult.
If you don’t know where it is, it’s hard to reuse a topic, but it is still possible (hunt for it based on file name? ask your fellow writers over coffee and a doughnut?). But if you don’t know it exists, then how can you know that you could have spent five minutes searching the CMS for a topic that was almost perfect for you instead of five hours writing it. (And don’t forget you can reuse graphics, too.) Not quite right for your topic? You guessed it, you can get the CMS to change it for you but keep it the same for the original owner—all without actually copying the topic. What about the original changes? The CMS lets you know that you can either roll those changes into your version or ignore them, as needed. Are you weeping yet?
- Your manager turns to you and asks, “So how much money have we saved the company since we started writing with DITA?” At your blank look, she then says, “Let me know by the end of the day. Management has asked for hard numbers.” Now you are contemplating the pros and cons of creative number crunching.
A CMS can provide metrics that tell you how much reuse you’re employing. You can also easily identify when you started working on a project, in the case of extreme temporal memory malfunction, letting you calculate the time it took for the project from end-to-end. Now you can use the time you saved writing making pretty graphs instead. And everyone knows that management likes pretty graphs.
Are we recommending a CMS for everyone? Frankly, yes. Unless you only have one writer, one product, never update documents for new versions, never translate … well, then, you’re not really a writer, you’ve just written. You can’t expect to fix all your problems automatically with a CMS, but you can save time, money, grief, and possibly your job. And while you’re at it, use the CMS to enforce the process improvements you’ve been meaning to introduce, such as publishing automatically every night, and introducing some information architecture solutions.
There’s a CMS solution that’s right for you, from the little guys that just get the job done to the Cadillacs that get it done with flair, bells, and whistles—and also let you know when you’re being stupid. Stop stalling. The return on investment of a CMS is between two months and two years, with the average around a year.
Can you afford not to have one?
Jacquie Samuels is the owner of Writing Wise (writingwise.biz) and a CMS consultant with Publishing Smarter, a Canadian company that specializes in DITA training and conversion, CMS selection, customization, and training, as well as training in FrameMaker, oXygen, and XMetaL. Publishing Smarter is a certified partner with Vasont Systems and the official trainers for Bluestream’s XDocs.
