The version suicides, Part 1

by Rob @ 52 Novels on January 30, 2008

This entry is part 1 of 2 in the series The version suicides

Looks like you're new here. Get all the fun of 52 Novels as it happens and subscribe by e-mail or subscribe using your favorite RSS feed reader. Might as well. Don't cost nothin.

The ON THE ROAD scroll
Image by Thomas Hawk, via Creative Commons. Courtesy of flickr.

Sorry.

That headline’s bad. Really bad.1

But try and set that aside for a moment and follow along with me, because this series just might save your ass.

First, though, close your eyes and imagine a world where writing projects—whether they’re novels or family holiday newsletters—go smoothly, from the first shitty draft through the final polished revision, ready to release into the wild of the real world.

Keep your eyes closed.

Next, I want you to visualize never having <Ctrl-Z> rendered useless by a sudden loss of power to your computer.

Now imagine a writing session where you’ve noodled with a paragraph—or an entire scene or chapter—and absolutely adored every word you wrote. In fact, you loved it so much you clicked Save the second after you wrote it because it’s as perfect as perfect can be.

Now wake up, because that world exists only in a dream.

We all know the reality of things is much, much different. No, what we experience is typically opposite of how we want it to go:

  • Microsoft Word crashes and we pray to the Writing Gods, as the program restarts, that the auto-recovery save ran sometime before the doc went tits up. But we all know too well that we’re probably hosed.
  • We spend a half hour tweaking a scene, hitting <Ctrl-S> numerous times. You know, just to be safe. Then we realize we liked it better the way it was two days ago.
  • We leave an unsaved version of our work open on the computer desktop and a family member closes it down. “Oh, I just clicked No because I assumed you saved it already.” This, of course, leaves us channeling Nancy Kerrigan, circa 1994. “Why? Why? Why?”
  • Insert some other similarly tragic end here. There really are eight million stories in the naked city.

I’m a tech writer at my day job. I work with and write about technology just about every week day of the year. As part of that work, I maintain more than a dozen book-length printed documents and nearly a thousand HTML files. (Yes, I realize that’s a silly nightmare considering how simple it is to deliver dynamic content these days.)

Considering, my co-worker and I would be screwed if we didn’t have some sort of system that helps us keep track of versions. That’s why we use version control tools.

“What’re those,” you ask. “And why should I care?”

Were you not paying attention? Jeesh. You think I type this stuff up for my health?

In all seriousness, version control tools allow you to keep track of multiple versions of your documents without actually maintaining multiple copies of the documents themselves. With version control you can forever banish Save as… to the Island of Unused Toolbar Commands.

How is this possible?

Simple.

Version control tools are just repositories—or databases—that do all the revision management for you:

  • No more maintenance of multiple files and folders.
  • No more cryptic file naming conventions to keep things straight.
  • No more remembering whether you just did a Save as… or a normal Save.

Intrigued?

Then be sure to drop by in the coming days for parts 2 and 3 of… The version suicides.

Tags: , ,

Sphere: Related Content

  1. Count your lucky stars… I almost titled this series, “Versions? We don’t need no stinking versions.” []

{ 2 trackbacks }

The version suicides, Part 2 at 52 Novels
02.07.08 at 7:14 am
Darren went on holiday and all I got was a lousy guest post at 52 Novels
02.29.08 at 8:17 am

{ 3 comments… read them below or add one }

1

Yogamum 01.30.08 at 10:48 am

Okay, I’m listening! Can’t wait to hear more about how to manage all this stuff!

2

Rob @ 52 Novels 01.30.08 at 6:43 pm

Look for part two soon, mum. ;-)

3

cmdweb 02.01.08 at 2:56 am

Couldn’t agree more. I’m going looking for the next installment. Version (or config) control is a big issue for us tech writers and gives us some key knowledge to use when we try our hand elsewhere. Keep up the good work, the posts are great!

Leave a Comment

You can use these HTML tags and attributes: <a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code> <del datetime=""> <em> <i> <q cite=""> <strike> <strong>

Note: This post is over 8 months old. You may want to check later in this blog to see if there is new information relevant to your comment.

Older post: Stupid cat

Newer post: The Sunday Salon and I’m a FOMAC