Want to write an Operations Guide? This tutorial explains how to write your first operations manual. It helps you get started, suggests how to format the document, create the table of contents and what else you need to include in a sample plan. The Operations Guide Template will help you run your IT environment more efficiently. It […]
11 Examples of REST API Documentation
Looking for examples of API documentation online? Wondering how the big boys write their API documentation so you can get a little inspiration? Me too. //Get the REST API Documentation Tutorial here We’ve being writing a lot of API documents recently for a new client. She asked for examples of how other IT companies publish […]
22 API Document Generation Tools
Want to document your Web and RESTful APIs but don’t know where to start? Me too. APIs are great but they also need documentation. I did a bit of hunting and compiled this list. It’s in no particular order of preference. I sorted them A-Z. [Get the API Documentation Template here] 21 API Documentation Tools […]
NEW – Quality Assurance Plan Templates (MS Word + Excel)
This week we created a new set of Quality Assurance Plan Templates. I sat templates as we developed more than just the MS Word template, but sample materials, and also seven pretty slick Excel spreadsheets. If you’re involved in tech writing or software testing, I think these templates will be of real value to your Quality […]
Installation Guide Checklist: Sample Template For Technical Writers
In the introduction section, identity the software you are about to install, steps to prepare for installation, running installation scripts, and post-installation tasks after the installation script has completed. In general, your installation guide will include most of the following: Introduction Choose the Installation Type Concepts Setup Pre-Installation Requirements Pre-Installation Checklist Installation and Configuring Procedure […]
Difference Between SOPs v Work Instructions v Procedures
How can you tell if a document is a SOP, Procedure, or Work Instruction? Also, what are the connections between each of these documents? Is one more important than the other? Do you need to write an SOP before the Work Instruction… or should it be the other way round? Download Work Instruction Templates for […]
Documentation Plan: Which Technical Documents should I write first?
Documentation plans – where do you start? Which technical document should you first write when starting to a new tech docs project? KB emailed me this question. When starting as a technical writer, it can be hard to know where to start writing, especially if many people have different documentations needs. Here’s how to get […]