Posted on

NEW: 39-page Quality Assurance Plan Template in MS Word/Excel

Looking for a Quality Assurance Plan template? We’ve spent most of the week polishing this fella and now he’s ready for prime time. See what you think.

Quality Assurance Plan Template

This template pack includes a 39-page Quality Assurance Plan Template in MS Word, an Audit checklist and Schedule Forms, and 7 Excel spreadsheets. You can use this template to write your first QA plan. It includes helpful explanatory text that walks you through the process of setting up your first QA project. You can change everything in the document – text, images, and tables. There are no special plug-ins, macros, or installation files. Just download the templates and get started.


Business Case Template - Download Here

Quality Assurance Plan Definition

The Quality Assurance Plan describes the approach to ensuring that software is delivered according to a set of agreed quality guidelines. It ensures that the:

  1. Project is managed, developed, and deployed correctly.
  2. Deliverables are of acceptable quality before delivered to clients.


In the Quality Milestones chapter, we’ve added a nice Note to the text to display some instructional text.


Here in the Documentation section, you can see how the chapter numbering, fonts, text, and tables are presented.

Why do you need a Quality Assurance Plan?

The Quality Assurance Plan ensures the project provides quality within the allocated resources, schedule, and budget.

How to use the Quality Assurance Plan

  • Address specific project processes and deliverables.
  • Establish criteria that defines the quality at each checkpoint or deliverable.
  • Identify roles and responsibilities for the quality assurance reviewers.
  • Define who, where and when quality reviews are performed.
  • Apply the Styles, such as those shown in the following screenshots, to ensure a consistent look and feel through-out the document.


Examples of Styles for the Body, Bullet lists, Notes, Table text and headers

Quality Assurance Plan Purpose

Use this Software Quality Assurance Plan to document the process, methods, standards, and procedures for your next software testing project. Use this document as a foundation for managing software quality assurance activities and project activities as documented in the Project Plan.

This Quality Assurance Plan will help you:

  • Identify the SQA responsibilities of the project team and the SQA consultants
  • Define reviews and audits and how they will be conducted
  • List the activities, processes, and work products to be reviewed
  • Identify SQA work products


Examples of different notes, message, and warning styles you might want to add to your Quality Plan

Who is this template for?

This template was written for QA Managers, especially those who may be new to this area and are looking for a little direction on how to get started. The forms, checklists, and spreadsheets will also help you get up to speed fast.


Learn more about the template pack here.

Posted on

Configuration Guides: How To Document Parameters


So, you want to document the parameters for your new Configuration Management Guide.

Where do you start?

Here’s a checklist of what you need to capture when documenting parameters in technical documentation:

Parameter Name

Specify the name of the parameter with consideration to case sensitive naming conventions. Likewise, use the correct format and styling when entering parameters to your documents.


Download the Configuration Guide Template here.



Specify where in the configuration file that parameter is located. For example, is it part of a specific parameter set or a section of common parameter setting?

For example: This table describes the Log parameters of the Common section:

In this case, the Log parameters are part of a common set of parameters used by the service, server, or application.


Describe the benefit to the user when this parameter is configured. Outline what it enables them to achieve and, if necessary, any downstream impacts. For example, if you turn on this option, other options are made unavailable.

However, make sure you provide enough information for the user to understand the parameter’s purpose and also how this impacts other parts of the system, for example:

Defines a locally stored backup license file. This provides protection against interruptions occurring if the connection to the license server is lost.


Describe if this parameters activities are impacted by other parameter settings, for example:

Defines if a new log file is created at the time specified by the Time parameter or when the current log file reaches the size specified by the Size parameter.

A second example is if the settings are enabled if another setting is set to a specific setting in a different parameter, for example:

Defines if messages are filtered according to the Filters parameter if the Verbosity level is set to comm.


Describe the parameter options is the settings are turned on or off. For example, state which options are available and then describe the settings.

  • True – describe what occurs if the True setting is selected, for example, enables statistics support.
  • False – describe what occurs if the False setting is selected, for example, disable statistics support.

Default value

Some parameters come with a default value, for example, 0, 1, Yes or No. Specify the default value so it’s clear to the reader if they need to change the setting or leave it in its default status.

Use the following phrasing: This is the default value.


Highlight if this setting impacts other parts of the system, for example, it overrides another parameter’s settings, disables another feature, or impacts the performance of the system.

Related documentation

If necessary, direct the reader to other sources of information which may help them understand the parameter a little better. For example, if it impacts another module or system.


State if the parameter is mandatory.

Note – identify any recommended settings or values which must be set for the parameter to function correctly, for example:

The value of the parameter must match the value specified for the Metrics parameter.

Minimum Settings

A second example is if the parameter must be set to a specific setting, for example:

The value of the parameter must be equal or greater than the value of the TimePeriod parameter.

Multiple values

For some parameters, you can specify a default value, for example, 1000 but also highlight other possible settings, for example:

The default value is 1000. The following values can also be defined:

  • 0 — no data is sent to the server.
  • 1 — data is sent to the server as soon as it is collected. This value reduces performance.

How to document parameters

Describe the parameter settings as follows:

The first sentence describes the purpose of the parameter in a single sentence.

The second sentence describes the available options and highlights the default settings, for example:

The following options are available:

  • True — enables statistics support
  • False — disables statistics support. This is the default value.

State if the parameter is mandatory. Use the following phrasing:

This is a mandatory parameter.


The skill in documenting parameters in technical documentation is to describe both the parameter and how it affects other settings, modules, or applications.

This means, as a technical writer, you need to understand how it connects to other parts of the system.

Without this knowledge, your documentation may be adequate but not help the reader understand its impact on other products.

PSDownload the Configuration Guide Template here.