Technically Writing With Purpose

(Inspired by a writing prompt from The Daily Post)

One of the things I love about technical writing is the ability to write without having to resort to flowery language. While embellishing an email or newsletter is fun on occasion, I do not need to tell a story in a user manual. The only epic journey involved in furniture assembly involves a trip to IKEA  during a holiday weekend. My purpose in creating documentation often involves explaining something, and then removing half the words in the hopes that users will be less scared by a 50 page manual than a 100 page manual (do not be scared reader, I have graphics!) While I am exaggerating a bit, there is a reason you will never see this in a user manual:

You are advised to enter as many search fields as possible, for when accessing the seemingly infinite cosmos of data records, a broad search may bring thousands, nay, tens of thousands of results! While one could seek the aid of “alphabetical” or “recently added” sorting options, the daunting task of filtering so many records is certain to bring you to your knees after reaching page four of four hundred with not even the slightest hint of your beloved result in sight. So beware, dear reader, always enter at least two or three search terms, least you find yourself staring directly into the abyss.

Instead, I would write something like this: Enter additional search criteria if too many search results appear.

My purpose in technical writing is often to explain, not to reveal anything about myself. This might sound odd to the student tasked with providing original thought and justification, but even in creative writing a little brevity (and a little less preposition use) can go a long way. Your editor will thank you later.

Leave a comment

Filed under Technical Writing, Writing

Goodreads Quick Review: Raising Steam

Raising Steam (Discworld, #40, Moist von Lipwig #3 )Raising Steam by Terry Pratchett

My rating: 3 of 5 stars

Although technically a Moist Von Lipwig novel, this read more like a “farewell to Discworld” novel. With the arrival of the steam engine, a lot of page space is dedicated to Discworld characters discussing, riding, or fighting atop the locomotive…in some cases all three at once.

The plot is relatively tame, and constantly interrupted with irrelevant cameo scenes from Discworld characters across its storied history making one final appearance. The central conflict is mostly subdued and then quickly dispatched with some hit you over the head moral lessons about fantastic racism along the way.

While this is a good novel, it is not much of a Moist novel, which I find disappointing because I love Moist. Still, as the final “complete” Discworld novel it does provide a nice ending to Ankh-Morpork and its crazy cast.

View all my reviews

Leave a comment

Filed under Book Reviews, Reviews

The Seven Deadly Sins – Anime Review


At first glance, The Seven Deadly Sins looks like a run of the mill Shōnen anime with a medieval fantasy twist. Indeed the story sounds all too familiar: Elizabeth, a naïve, helpless princess with a good heart escapes from her corrupt kingdom (complete with sick bedridden king and evil regent!) to recruit the titular Sins, a merry band of asskickers who once served the kingdom before mysteriously disappearing after being framed for a murder they did not commit ten years prior. While this sounds like the setup for a medieval A-Team, none of the Sins are together anymore and mostly do not feel compelled to live altruistic lives. With the help of Meliodas, Captain of the Sins and name of my next Dungeons and Dragons character,  Elizabeth sets out on a journey to find the remaining Sins, save the kingdom from the corrupt Holy Knights that now run the show, and shed some light on the aforementioned mysterious murder that set this plot in motion. As this universe was also inspired by someone Dungeons and Dragons epic-level campaign of munchkin powerhouses, you can also count on the appearance of dark magic, demonic powers, a talking comic-relief pig, and the obligatory historical domain character cameo.

The Seven Deadly Sins - obscured by shadows for maximum intrigue.

The Seven Deadly Sins – obscured by shadows for maximum intrigue.

The opening episodes quickly establish that the Sins do not require the emotional resolve needed for typical Shōnen protagonists to unlock the depths of their powers, beat the odds and save the day as is the case in shows like Dragonball, Naruto, or One Piece. The Sins are quite capable of providing bursts of power on their own as needed, which tends to be after a sufficient amount of drama has passed or the resident foolish princess interjects herself into combat situations.  While it would beeasy for most of the Sins to appear arrogant, they thankfully do a good job of not outwardly showing it, instead shrugging of danger with friendly banter mixed with “been there, seen that.” Emotional shōnen powerups eventually appear, but they are mostly reserved for the final act with the exception of a few nice hints of foreshadowing (there is a good reason Meliodas fights with a broken sword).

So how do you create compelling action scenes with such over-the-top displays of badassery? Why with an equally badass group of immoral villains. This being medieval fantasy, that gives us the “Holy Knights” a faction of corrupt Knight Templar who, like all good fictional Templar, are more gray than white on the scale of holiness.  Since this is a Japanese anime, the idea of fantasy magic manifests itself more as an (often elemental) extension of physical combat instead of magical chanting. In other words, the characters are more “magic knight doing cool things with weapons” as opposed to “the wizard casts a spell.” While the latter does appear from time to time, this universe hasn’t quite figured out an answer to the age-old “magic is mysterious enough to solve everything!” conundrum so traditional displays of magic are reserved for moments of maximum plot drama.

A typical attack. Note the large over-the-top explosion.

A typical attack. Note the large over-the-top explosion.

This might sound like an anime twist on a stereotypical high fantasy adventure, and that is what you get at the end of the day. Despite the lack of originality, the anime is pretty good and fun to watch. There is plenty of compelling storytelling scattered around the fighting, and each of the Sins have very complex, well-written stories that gradually come to light as they each have their moments in the spotlight. This spotlight is frequently shared by the antagonistic holy knights, with their own complex pasts that bring a touch of gray morality to the entire cast. While I do have to knock the story a bit for being slightly too optimistic and cheery overall, it is nowhere near Disney-level and there are plenty of dark, dramatic moments.

While the Seven Deadly Sins may not break any new ground, the anime plants a lovely garden of action and plot in the old ground. If you like high fantasy or seeing crazy Dungeons and Dragons-esque adventures come to life, this short anime series is worth a look.

Leave a comment

Filed under Reviews

From to

I used to consider taking the leap into This article effectively sums up why I didn’t. Sometimes the simplest solution is best.

Live to Write - Write to Live

wordpress-logo-stacked-rgbI recently moved my personal blog from a site to a site and thought I’d share the experience in case anyone else was considering a similar move.

WordPress is a blogging software that comes in two flavors. offers free software that you download and install on a server (most people rent server space from a hosting company). offers a hosted version of the software, a basic site is also free, but there are premium options that provide personalization (like using your own domain name) and customization (number of columns, header size, colors etc). A site is a good idea for someone who wants complete control of every aspect of their website or blog. A provides allows more of a point and click interface. The trade off is that you have limited options on, still for most end users will meet their needs.

View original post 745 more words

Leave a comment

Filed under Web Design

Goodreads Quick Review: Abraham Lincoln: Vampire Hunter

Abraham Lincoln: Vampire HunterAbraham Lincoln: Vampire Hunter by Seth Grahame-Smith

My rating: 2 of 5 stars

Abraham Lincoln: Vampire Hunter portrays itself as a truth-seeking biography of Lincoln’s life…specifically that he was actually a paranoid maniac who wanted to hunt down all the evil vampires because they killed his mommy. And because all vampires are evil…except the few that are not.

Hey, at least they aren’t good sparkly vampires.

This is not a good book, and for that I am very disappointed. Abraham Lincoln hunts vampires – how can you go wrong? With clumsy writing and horrible pacing for starters. Put simply, the plot takes a long time to get going, and once you get to the part of the story where things should get really good (The Civil War, which is naturally a vampire plot to enslave all humans) you are over three-quarters of the way through the book. Long stretches of time are devoted to Lincoln rambling about his hatred of vampires, or characters that do not deserve it (John Wilkes Booth who is, surprise surprise, a vampire, could have had his own novel)

If you want to portray Abraham Lincoln has a super cool vampire hunter, then you need to abandon your inhibitions and take no punches with your writing. Unfortunately the author seems nervous about tackling one of the most famous figures in America, and the end result leaves poor Mr. Lincoln a shell of a man.

One tip if you decide to read the book: skip the prologue. It can be safely ignored, and as a framing device (though I hesitate to label it such) it is never brought back at the end.

View all my reviews

Leave a comment

Filed under Book Reviews, Reviews

Goodreads Quick Review: Proven Guilty

Proven Guilty (The Dresden Files, #8)Proven Guilty by Jim Butcher
My rating: 3 of 5 stars

I can always count on Jim Butcher’s Dresden Files for an enjoyable (and memorable) read. While Proven Guilty is no exception with its avalanche of movie monsters, fairy monsters, and courtroom drama, it simply lacks the punch of Dead Beat and the last few books. The intense life and death struggles are still here…they are just sandwiched between a lot of drama.

While I give Butcher some credit for playing with the formula a little bit, it could have done with about 50 less pages of Harry’s existentialism over trying to be the perfect hero (we get it, you feel bad about recent events, you can stop reminding us every other page) and his sudden desire to act on his Murphy feelings (lets not kid ourselves, we all knew how round one of this was going to end). The extra pages gained could have helped him on the rushed trial sequence at the end.

Speaking of sudden, I give Butcher extra credit for creative use of divine intervention. Every time a Knight of the Cross story comes up, I always fear a cop out in the form of “he works in mysterious ways.” This book does a wonderful job of playing with the concept, so perhaps I should stop worrying and love the Butcher.

Don’t let the three stars and review fool you. The sharp writing and clever humor remain intact and I enjoyed the book. But if I compare it to previous books in the series, it just lacks the Forzare! of previous books.

View all my reviews

Leave a comment

Filed under Book Reviews, Reviews

Goodreads Quick Review: Grave Peril

Grave Peril
Grave Peril by Jim Butcher
My rating: 4 of 5 stars

The third entry into Jim Butcher’s paranormal-fantasy-detective series continues with another fresh entry. Well, this particular story isn’t “fresh” per-say as it deals with undead ghosts and vampires, but you know, good writing and whatnot.

This time around, Harry’s partner in crime Murphy is replaced with the modern templar Michael Carpenter (heh). The stories I heard about Butcher being an avid Dungeons and Dragons player are clearly true. Michael is quite literally a classic Dungeons and Dragons lawful good paladin stuck in modern day America. Place Michael with the agnostic Harry as they battle a supernatural threat, and Butcher can virtually abandon any plans he has for this series and make his own fun version of hit-TV show Supernatural.

There’s also Susan, Harry’s new beau with whom I am sadly forced to dock a star. Chalk it up to a classic case of rushed relationship pacing if you will, but the chemistry between Susan and Harry simply wasn’t up to par with the chemistry between Harry and pretty much every other character. Even two-scene-wonder Thomas, who would have stolen the show in any other book.

In the Harry Dresden universe, assertion is meaningless unless you have the skills to back it up. Perhaps Butcher realized this as well because…well…let’s just say I don’t share Harry’s state of mind at the end of the book. For me it’s more of a “Thank Go-err goodness that’s over with.” (Sorry Michael) Speaking of moving on, Butcher continues subtly laying the groundwork for a grand story arc in what appears to be pretty stand-alone stories at first glance.

View all my reviews

Leave a comment

Filed under Book Reviews, Reviews

Goodreads Quick Review: Fool Moon

Fool Moon
Fool Moon by Jim Butcher
My rating: 4 of 5 stars

Butcher’s second entry in the Dresden Files once again shows promise for a great long-running series. Once again someone is in trouble, but this time around danger comes in the form of werewolves instead of freak meteorology.

Every world-building writer has their own ideas on how fantasy elements like werewolves work. Butcher quickly explains Dresden Files lycanthropy in a concise and well-written info dump courtesy of everyone’s favorite perverted skull while Dresden gets to work. The werewolf angle works well, but I’m really tired of all fantasy writers’ need to make supernatural creatures condescending towards the human race. Humans are stupid, pointlessly violent, and so on…we get it.

I recently stumbled upon an interview in which the first few Dresden Files books came about because Butcher, in getting frustrated with his writing professor, finally broke down and wrote something he considered “boring and formulaic.” While this book is formulaic (a lot more so than Storm Front), it certainly isn’t boring.

Is that a bad thing? I don’t think so. Butcher seems content to play along with the formula for now, but the end of story allusion that much deeper threats (and stories) are on the horizon will keep me coming back for more.

View all my reviews

Leave a comment

Filed under Book Reviews, Reviews

Technical Writing: The 60th Best Job in 2013

Some interesting statistics about the technical writing profession over the last few years. I’m surprised it has slipped so much in the rankings, although there is a lot of competition for jobs requiring technical skills.

Technical Writing ToolBox

Technical Writing is the 60th best job in 2013 Technical Writing is the 60th best job in 2013

Following the yearly tradition, Comcast released  a list of top 200 different jobs in the U.S based on five criteria: physical demands, work environment, income, stress and hiring outlook. The data for this report came from the Bureau of Labor Statistics and other government agencies in U.S.

Technical Writer was the 60th best job in 2013 though it slipped 23 ranks as it was the 37th best job in the same survey in 2012, and it slipped 34 ranks as it was the 26th best job in the same survey in 2011. Read the complete list of Careercast 200 tops jobs in 2013 here and the methodology of ranking here.



Average Salary of a Technical Writer in 2013

Average salary of a technical writer in 2013 is $65,178, up 3% from last year.


Work Environment for Technical Writing job

Technical Writing received a score…

View original post 191 more words

Leave a comment

Filed under Technical Writing

Goodreads Quick Review: Redshirts

Redshirts by John Scalzi
My rating: 5 of 5 stars

At first glance, Redshirts looks like an obvious parody of the Star Trek red shirts. Specifically, the poor nameless extras whose only purpose is to die horribly at the hands of whatever threat the important crew officers encounter. And…well that’s actually the entire point. Literally.

This book is what happens when the red shirts become self-aware. For as it so happens, the red shirt heroes soon realize that they actually are part of a science fiction TV show narrative that exists in the real world. A not-unlike-Star Trek narrative where the Captain, Science Officer, Lieutenant, and so on always survive the most dangerous of ordeals time and time again while the ensign red shirt are left to perish.

What follows is a hilarious and crazy-awesome adventure whose sheer mind-screwiness plays basketball with the timey-wimey ball of Doctor Who fame. Suffice to say, if you are a Star Trek (original series) fan or a lover of lighthearted science fiction, you will enjoy this book. A few words of literary warning: this book is *extremely* dialogue-heavy. If you like your conversations broken up with consistant action, you may get annoyed as the book moves on.

Bonus points for having a brilliant ending, and I mean “the last two pages” kind of brilliant. Plus, given the overall comedic scope, the final epilogue sequence is inexplicably heartwarming. Grab some tissues beforehand. Scalzi ties everything together, beginning and end and everything beyond, through the skillful words of a veteran writer.

View all my reviews

Leave a comment

Filed under Book Reviews, Reviews