Categories
Business Networking Process

Why We Write

Whenever I can squeeze an hour out of the month, I like to attend the TAG (Technology Association of Georgia) presentations of what they call technology “Rock Stars.”  This past week, Val Rahmani from Damballa spoke about her experience moving from almost 30 years at a large corporation to running an internet security start-up.

Categories
Business Writing

Fixed-Price Proposals

At Shoap Technical Services, we take pride in our ability to offer our clients fixed-priced bids for technical documentation and training.  We feel that this is an advantage to our clients because everyone likes to know how much a project is going to cost before they start.  And we feel confidant that we can correctly estimate a project because 1) we’ve done so many technical writing and training projects over the past 25 years and 2) we’ve learned how to break down a project into small enough parts so we can assign numbers (time) to each part to determine a total cost.  What we like to say is, “If we can put our arms around the project, we can successfully bid it.”  While we have, at times, missed our estimates and had to finish a project at a loss, most of the time we’re pretty accurate.  That makes our clients happy because they know from the outset what they’re going to have to pay and it allows us to make enough money to stay in business.

Categories
Business Process Writing

Expanding Markets Means Expanding Understanding

Aberdeen Group completed a study earlier this year that indicates when technical communications are approached strategically, companies provide significant customer-facing value. – David Houlihan, Senior Research with Aberdeen’s Product Innovation and Engineering Practice.

Categories
Business Writing

Manuals: Why They Do Not Matter

Christmas, 2009:
The penguin wrapping paper is shredded from an oblong, rectangular package, carefully branded by a stark white apple on black monochrome — The Apple iPod ® Nano. The product is reverently lifted from the case along with the ear buds and sleek quick start guide, leaving the thick, intimidating, and unhelpful paper manual in the bottom — it might as well have been packing peanuts. Why do manufacturers bother with the archaic manual documentation which wastes paper, takes up unneeded space, and adds weight to the shipping fee? The product is blithely toyed with, prodded, poked, and explored without so much as a cursory glance to the woe begotten manual in the box, the user happily glancing through the quick start guide if they come upon any snags in the process of operating their new system. The manual is never read, collects dust, and slowly sinks into oblivion. Let’s explore why the manual falls to such a fate.

Categories
Business Process Writing

Going Agile with Technical Documentation

… we have come to value … working software over comprehensive documentation…

Agile Manifesto

We don’t do a lot of work with practitioners of agile methodologies. I think that’s partly because there’s some built-in hostility towards documentation in the values of agile development. Of course, while the Agile Manifesto is referring mostly to documentation for the front end of the cycle (i.e., the giant FRS), that hostility ends up spilling over to end-user documentation as well. (I don’t think that was the intention.)

Categories
Business Visual Aids

Clients, Please Choose: Good, Fast, or Cheap?

goodfastcheap

Clients often want everything, but the simple truth of the matter is that nobody gets everything they want – there is always a tradeoff somewhere, and that can be hard to explain to management types.  This is a struggle that every hired gun will have to deal with eventually, but it CAN be done!

I recently came across an intersting post at Future Perfect which explains the concept very simply using Rhys Newman’s handy graphical representation of the triangular relationship between fast, good, and cheap.  Just remember, the closer you get to one of these, the further you are from the other two.

This is defnitely something you’ll want to keep in your toolbelt when pitching projects to clients.

Happy estimating!

Categories
Business Process Writing

Making New Programs Easier: A Case Approach

It is often difficult to know what the priorities are when creating a successful new program. As a project manager for Shoap Technical Services, I have a fair amount of experience initiating new projects. Over the years, I have developed a few key “rules” for every project. While I could just go through my list and explain why I think each rule is important, I think it is easiest to learn through experience, so I have illustrated them through a case study of a recent project.