20+ years of technical writing experience


FAQs

Note: this section currently being edited (Sept 2017)

Where are you located?

Why hire an independent writer?

What are your writing capabilities? with portfolio samples

What are your illustrating capabilities? with portfolio samples

What are your desktop publishing (DTP) capabilities?

What is your project management experience and approach?

How can you claim to be so much more productive—while delivering higher quality results?

What software tools can you use?

Are you expensive?

Do you work by the hour or by the job?

What about travel and other expenses?

What do you need from a potential client in order to provide a quote?

What about a work contract and client confidentiality agreement?

Are you willing to relocate for a project?

Are you willing to travel out of the country?



Where are you located?

Currently in Portland, Oregon. Also see this.

Why hire an independent writer?

An independent technical writer is typically one who is highly competent and is confident enough in his/her abilities to not require the security of company benefits and a regular paycheck. You can have this experience and competency working for you at less than the cost of an in-house writer—while not being committed to providing a steady 40 hours of work per week.

Cost savings:

You don't need to provide me space to work or equipment and software licenses.

You are not responsible for my social security, medical insurance, workers compensation, sick leave, holiday pay, or vacation pay.

When you don't need me for a while, it's not a big deal. I will enjoy the time off.

Productivity matters:

I use e-mail, FTP upload, or FedEx to get your product to you.

I can conduct information-gathering interviews over the telephone.

If I need to see it, run it, take it apart, or install it, I will happily come to your site.

Working off-site, my productivity is greater because:

I can enjoy long periods of focused concentration without interruption

I'm not affected by distracting office noise and politics

I work during times of peak productivity, which may not always be 8-5

Instead of commuting I can be working

I work through holidays when necessary

What are your writing capabilities?

Comprehension should be a writer's aim—first and foremost. Technical writing that is difficult or impossible to comprehend is worse than useless because it:

wastes the time of people on the job (and one technician's delay could have a huge ripple effect)

creates a negative impression of the company behind the product

fails to achieve the goal of decreased equipment downtime

results in calls to the service department

may result in equipment damage or injury to persons

My goal is to craft text that can be comprehended on first reading—even if the subject matter is unfamiliar to the reader and conceptually complex.

How many times have you encountered a description of a process or procedure that, even after numerous close readings, you failed to comprehend the writing? Lack of clarity is often the reason.

To achieve clarity in my writing, I use the following techniques. These can also be thought of as "self-editing" checks on one's writing, and will help ensure cohesion and coherence as well as clarity.

My Top 6 Essential Technical Writing Techniques for Achieving Clarity

Here is the interesting thing about these techniques—they act as a test of the writer's own understanding of the subject! Gaps that may exist in a writer's own comprehension of the subject matter will most likely be revealed to the writer when these techniques are employed.

[future example here] (preliminary manual version)

What are your illustrating and design capabilities?

I have experience providing many different types of graphics. The type of graphics used will depend on the specific situation, resources available, and client preference.

Photographs are the most efficient method to illustrate a process or procedure, and experience is helpful in getting shots that are clear depictions of what you are trying to illustrate. And once you have a decent shot, there are some simple steps that can be done using Photoshop to greatly enhance a photograph and make it worthy of inclusion in a quality document.

More below.

Information Design

I always ask the question, "What graphical enhancements can help communicate this information?" Often, redesigning the text is all that is required, such as simply breaking a long paragraph into shorter ones or using a "Note" or "Important!" paragraph style. And of course, [future example here] a well-designed table or graph can greatly enhance user comprehension and access.

Other situations might require an infographic such as a piping and instrumentation-type drawing (PID), a data/control flow diagram [example 1] [example 2] or schematic diagram [example1] [example 2] to provide a quick visual overview of how a complex system is arranged and interconnected.

Creating a PID requires that the technical writer be a competent reader of schematics and able to comprehend and visualize large complex systems. A skillful technical writer can create a PID that is accurate and informative while not being confusing or cluttered by unnecessary elements.

I have enjoyed working with many professional technical illustrators and I greatly appreciate their talents when they are available to me, but more typically I create my own graphics.

Original CAD drawings

The example is a procedure for removing a roll from a paper making machine. The drawings are to-scale, derived from drawings done on a drafting table. The facility had not yet been built.

Editing engineering drawings

Removed extraneous detail, drew in components relevant to the procedure, added callouts.

Original line art

The task was to create a graphic that conveys the instruction "Empty every day." Also see these wordless instructions.

Editing existing line art

In the above example, the original version was all one line weight with no shaded areas. It was impossible to see differentiate the structures. Working with the illustrator, I requested shading for some areas, some heavier line weights, greyed-out background lines, and removal of extraneous background detail.

It is important for the technical writer to evaluate existing graphics for how well they function in communicating the intended concept or structure.

Digital photographs

Computer screenshots ((future example here)

The first example is . . .

All too often, software screenshots are plunked down onto a page with little thought, i.e. with no explanatory call-outs or tie-in to the text, are inappropriately sized, or are illegible due to low resolution.

Original PIDs and schematics (See Information Design above)

Tables and graphs

The graph packs in a great deal of information. It was an interesting information design challenge.

The table originally was simply lines and data with no formatting to assist the reader—no shading, no space between rows, and no merged cells. The new table exemplifies how an information design perspective can lead to a usability improvement.

The table is also an example of the danger of never reviewing your boilerplate!
A check of the part number drawings revealed many parts were no longer available or were superseded. Furthermore, numerous dimensions given in the table were found to have been incorrect as well.

What are your desktop publishing (DTP) capabilities?

With a pretty good eye for design, typography, and page layout—these being the focus of my Master degree studies—I have designed manuals and other kinds of publications for many clients and employers. Elements on a page or digital display must be legible and arranged in a way that helps make the information accessible. Essential considerations include:

client preference or an existing corporate style

balanced page elements

adequate graphics

text and graphics that are sized appropriately

informative text headings and graphic callouts

eliminate any distracting elements

adequate headers, footers, TOCs

good indexing strategy

clean templates with minimal complexity

minimal paragraph and type styles

DTP Tools:

Adobe Framemaker—what do you mean when you say you are an expert user?

By "expert user" I mean that the Frame documents I create are built on elegant, streamlined templates of paragraph and character styles, page and step numbering, running headers and footers, index tagging, tables of contents, hyperlinks, etc.—without excessive complexity.

Since version 3 in 1993, Framemaker has been my DTP tool of choice, although I am equally impressed with InDesign.

What about Word?

Many people don't know this, but Word can be made to develop a large multi-section document. It has a book-creation capability that links chapter files. However, while I will use Word if that is a client requirement, I do not recommend it for technical publications.

Although Word has many of the capabilities of a DTP tool, it is essentially a word processor that has been pressed into service as a DTP tool. Word performs very poorly as a desktop publishing platform. It is unstable. Much of a writer's time is spent maintaining the formatting and keeping everything from blowing up. Yes, everyone is familiar with Word, but creating a simple Word document is much different compared to creating a multi-section technical manual based on a complex Word template.

What is your project management experience and approach?

How can you claim to be so much more productive—while delivering higher quality results?

A short answer to the question is that this work simply comes natural to me. And I enjoy it. Add the fact that every hour on the job is an hour of solid work.

A more detailed answer is that I can both be super-productive and deliver a high-quality product because I . . .

Typically I will blast through a client's projects in less than the estimated time while taking on numerous additional fix-it tasks and raising the bar on the documentation they've been used to getting from their in-house writers.

What software tools can you use?

My primary tools of choice are Framemaker, InDesign, Acrobat, Illustrator and most other illustrating programs, and Photoshop.

Also see the note above on using Word.

I have worked with many different illustrating and graphics tools and am flexible with respect to the tools a client wishes to be used. If the tool is new to me, I quickly come up to speed—on my own dime.

Are you expensive?

No, because:

1) I keep my overhead low, and
2) my focus is on productivity, quality, and getting the job done, not on how long I can extend a project.

My hourly rate is likely below the cost of a full-time employee and less than what a job shop would charge for an experienced technical writer.

The big advantage to you is that my productivity is much greater that of the typical experienced technical writer—while delivering a higher-quality product.

Do you work by the hour or by the job?

I am flexible and have no set preference as to hourly or by-project. A lot will depend upon the nature of the project and the preference of the client.

What about travel or other expenses?

Travel is the only expense for which I have ever requested reimbursement.

Occasional driving to a client site I consider a cost of doing business.

For overnight and air travel I would submit to the client an accounting of expenses incurred.

What do you need from a potential client in order to provide a quote?

Existing publication—editing and/or updating only

The usual first step is a site visit, but I have provided quotes when all communication has been by mail, email, and phone.

We would discuss:

the original documentation

the specific desires you have for the documentation

the extent of new source material available, such as engineering notes, drawings, or other product or process information.

the availability of subject matter experts and their commitment to the documentation effort

Quote turn-around time: typically 24-48 hours

New publication

A site visit is typically a necessity, but I have also provided quotes for new documentation when all communication has been by mail, email, and phone.

We would discuss:

the extent of documentation which exists for similar products or processes, if any

your challenges with respect to documentation requirements

the specific desires the client has for the documentation

the extent of source material available, such as engineering notes, drawings, or other product or process information.

the availability of subject matter experts and their commitment to the documentation effort

Typically a preliminary table of contents is delivered along with my quote.

Quote turn-around time: typically 48-72 hours

What about a contract and client confidentiality agreement?

If we decide to move forward on a project, I would prepare a very simple "Work Agreement" that basically reiterates the parameters of the project, identifies the project lead on the client side, indicates my hourly rate or the agreed-upon fixed price and invoice scheduling, and so forth. If requested, I can provide an example Agreement with my quote.

In addition to my Agreement, sometimes the client will have their own standard contract for independent contractors.

My signing of the client's Confidentiality Agreement is of course standard procedure.

Are you willing to relocate for a project?

Currently I am flexible to work locations within 100 miles of Portland. Having had many job-shop contracts, I am used to relocating to be near a client site.

For the right project and location I would consider temporarily locating my office near a client site. This could be accomplished in as little as 2 weeks.

Are you willing to travel out of the country?

I have a valid passport and am quite willing to travel.