Software refers to routines and programs developed for a computer system that allow the use to perform tasks or otherwise interact with the computer. The software could be provided by the manufacturer as a system component, or created as separate applications by the manufacturer or third parties. Documentation is a description of a product and how to use it. Software documentation describes software applications and how to use them.
Printed software documentation, sometimes referred to as software manuals, are often set up like a book, with a title page, table of contents, body, and index, and they often have some typical components. The first component most users need is an installation guide, and separate guides are given for the various operating systems the software works on, as needed. The installation guide lists the specifications that are required to run the software, including computer operating system(s), RAM, hard drive space, an Internet connection, and any other requirements or add-ons, such as peripherals. This is followed with step-by-step instructions for installation, which might be from a CD-ROM, a DVD, or a download, for example. Any unusual features of the installer and explanation of custom installation choices, such as alternate locations or streamlined installs, are generally explained.
A “quick start” guide is often the next part of the printed software documentation used. Picking up where the installation guide leaves off, the Quick Start guide helps the user get started with the software and its basic operations. This section may be arranged in a variety of ways, as suits the particular software. One popular method for task-oriented applications is a project-based introduction in which the user learns the basic functionality of the software while completing some mini-lessons.
Other elements that one would expect to find in printed software documentation include a complete run-down of the features, with emphasis on features new to the latest version; a list of updates since the previous versions, possibly including bugs fixed; information about how to obtain technical support; explanations of error messages; and information for advanced, or “power” users. Games and other software applications may include cheat sheets or hints in their documentation.
Printed software documentation is not the only kind. First of all, the printed documentation may also be available online or as a pdf. Additional documentation may also be available in the form of tool tips and help screens within the application itself, FAQs — lists of frequently asked questions along with answers, searchable articles, web training, videos, and other formats.
Software documentation varies quite a bit in quality, and this is particularly true of software manuals. The good ones can be excellent, while the ones that are not well-executed can leave users with many questions. There are also users who will not bother to search the documentation before asking questions on the software manufacturer’s forums.