Technical Writing

aboutmeMy name is Peter David Gustafson. I’ve been writing technical documentation since 2001 for tech companies of all sizes. Learn more about me.

Your technical writing or API documentation project requires working with a proven expert who can bridge the gap between complex data and readability.  I’m passionate about helping companies and programmers cut through the clutter managing the following types of projects:

  • API documentation
  • Internal documentation architecture design
  • Software user guides
  • White papers and digital marketing

API Documentation

Your company has likely built a dynamic software product or APP. However, when it comes to building API documentation, too many technical writers lack the necessary programming skills and software expertise to manage your project.

Why?

Around 2010, many technical writers fell asleep at the wheel. As UI design and software documentation went into hyper drive, these writers were forever left behind lacking the necessary skills to keep up with the industry. Specifically in programming skills. Great API writers (such as myself) are experts at the mission-critical elements of:

  • Working with the command line
  • Collaborating with programmers
  • Implementing single-source documentation architecture
  • Creating HTTP help documentation
  • Building logical graphics and tables
  • Producing video instructional documentation
  • Writing for all types of users

Your API documentation project deserves a technical writer with vast expertise in website design, file management and single-source architecture formatting to take advantage of a streamlined work flow. Having been involved with many API documentation projects, I assure you I’m your best candidate to manage your entire project.

Writing for all users while understanding their skill sets is critical. The following Stripe developer API screenshot gives you an idea of the types of content programmers desire along with code examples:

stripe-docs

User Profiling

Do you know your target documentation user? Often I find speaking with programmers can be valuable. However, remember that documentation is aimed to teach. Therefore, I like to evaluate your core target users and research their learning needs.

Translating what a ten year programmer knows about your software needs to be reduced to the lowest common denominator of user knowledge. Successful technical writing and documentation is about helping users find solutions quickly. Fully understanding your user learning challenges is mission-critical to solving their problems.

 

Output Options

flareTraditionally, technical writing required developing documentation for many output formats and devices (i.e. desktop, smartphone, tablet, Word, PDF etc.) by creating separate projects for each type. Not anymore.

With the robust functionality of MadCap Flare, we can approach your project in a single source format. Doing so streamlines production allowing multiple outputs of documentation from a single source of content rather than separate sources for each type of output.

Another benefit is you can import native file formats into Flare from other sources such as Word, FrameMaker, HTML and other types of help authoring tools. Doing so capitalizes on your current documentation file formats without the need to start from scratch.

The beauty of using Flare is it allows simple maintenance of documentation updates from one source.

 

Pinpointing Problems

ill-analyzerSuggestionsProject managers are busy people. As a technical writer, my job is to not only manage entire documentation networks but also identify and fix broken links and missing content. It’s not brain surgery if you have the right tools.

So what’s my secret weapon? Analytics. As your documentation grows, one thing is certain: it will become scattered. It’s the nature of the business. But not if you’re hard-wired with the right tool. From 10 to 10,000,000 documents, MadCap Analyze pinpoints broken links, missing data and provides rich data on user engagement (or lack thereof).

Hmmm…a technical writer proposing the use of analytics? Yes. In this day and age, gleaning enormous amounts of data is easy and beneficial to your documentation users. The bonus is you can capitalize on data trends of user engagement in your marketing of new prospects.

Are you tired of spending time and manpower on usability testing? Who isn’t? MadCap Analyzer is like employing a large scale documentation team (minus the steep payroll and excessive snacks) to scan and report compliancy issues as well as dozens of other content gaps such as:

  • Documentation identify issues for improved quality
  • Elimination of duplicate or unused elements
  • Identify ways to improve how content is developed and maintained

 

Technical Writing Visuals

pie-chart-256Recently I had a client who contracted me to write a complex user guide. The problem was they outsourced graphics and imagery to an overseas designer. Despite my best efforts to collaborate with their graphic designer with document needs, the project was delayed for months.

Why?

It was because of the segmentation of skill sets. By relying on a freelance designer they were handcuffed to his schedule which was far from timely. Too many technical writers lack graphic design expertise (unlike myself). Graphic designers aren’t writers. The result was my client created a communications gap. There’s nothing worse than waiting on part-time designers to supply visuals.

My approach is far different than other writers..

  1. I possess more than a decade of expertise in graphic design (Photoshop, Gimp, Illustrator).
  2. Visuals (i.e. graphics, charts and photographs) need to be developed in conjunction with the text.
  3. Task scheduling should be self-contained rather than outsourced to multiple contractors.

 

Video Documentation

video-player2Are text-based documents outdated due to the evolution of online video? Hardly. At the root of every user guide, tutorial and software API document is one goal: educate people in clean, easy-to-understand steps.

However, you have an alternative with video. I’ve worked with many clients who understand the benefits of converting help documentation into video demonstrations. In these types of projects, you need to evaluate the following considerations:

  • User video access: public vs. private
  • Public: YouTube is ideal and can be used as a marketing tool
  • Private: Wisita.com is the gold standard for privacy protection
  • Content: scripting, voiceover and screen footage
  • Production: video development, formatting and cost

Is video documentation right for your company? It is provided you’re ready to switch from text-based formats to video production. However, you want to avoid outsourcing your video production. The cost can be staggeringly expensive. My suggestion is to work with me since I’ve been developing video for many clients since 2007.

Note: not all of your documentation needs to be in the form of video. instead, it’s wise to review your user documentation analytics. Then focus on the content in high demand.

 

Progress Elaboration

Whether you’re in need of help documentation or user guide development, I recommend using progressive elaboration. Doing so breaks down your documentation into iterations. Each iteration results in:

  1. Defined steps.
  2. New incremental iterations.
  3. Builds upon greater functionality of previous iterations.
  4. Supports refinement of complex instructions.

 

My Background & Skills

For nearly a decade I was a senior account executive for a national advertising agency. By 2007, I witnessed the explosive demand of IT documentation and chose to branch out on my own. Read my full bio and resume here.

In 2008 I realized speaking with engineers and software developers about technical writing projects required me to be adept at specific programming languages. My tools of the trade…

tools3

Client Projects

microsoft

The white papers I wrote for Microsoft were technology-based. I had the privelege of working with their software engineering team to craft these papers: ONE | TWO

appleTechnical documentation needs to be clearly-defined and user-centric. I’ve been involved with a number of Apple product launches: ONE | TWO

skypeThe Skype API documentation project I worked on included rich media and specialized user instructions for novices and advanced programmers. VIEW PROJECT

jul-logoJulCreative.com is a recruiting and manufacturing marketing firm. The projects I crafted were an attraction recruiting eBook and an industry-specific white paper. Samples: EBOOK | WHITE PAPER