Personal Computer Documentation Standards
Personal Computer Documentation Standards
Division of Administration Policy No. 2
EFFECTIVE DATE: January 31, 1994; Revised August 26, 2002
SUBJECT: Personal Computer Documentation Standards
AUTHORIZATION: Whitman J. Kling, Jr., Deputy Undersecretary
Policy Sections
Policy Content
I. POLICY:
Documentation is required for applications developed for the personal computer to assure continuity of operation in the event of application, equipment, or personnel change.
II. PURPOSE:
To define the requirements for documenting applications developed on personal computers (PC) for use in the Division of Administration (DOA).
III. APPLICABILITY:
Applies to all sections within the DOA both appropriated and ancillary for all applications, whether developed by the section, by OIS, or by an outside vendor.
IV. PROCEDURE:
Each application, including regularly used spreadsheets and graphics, must be described in narrative form. The narrative should include purpose, package used (if applicable), source of input, primary output, processing description and controls.
Each program, including those purchased, must be documented. Documentation must be organized so that all elements relating to a program include:
- a narrative - describe purpose, identify input, files, edit rules (where appropriate), processing logic, output controls
- a current source listing or equivalent
- a sample report
- a printed layout of the screen/window
- file, record and transaction descriptions which define data elements include filename and extension, and drive designator.
Operating procedures and operating documentation must be current, dated, logically organized and contain:
- data preparation and entry procedures
- standard operating instructions
- a brief description of the task
- identification of all input and output
- setup instructions
- a list of operating messages and their meanings
- transaction, file, and/or output balancing procedures
- backup procedures
A procedure to control maintenance of the application programs should be established, and should require program change history logs and an explanation of the changes in the documentation, and should be maintained in a central location.
V. RESPONSIBILITY:
It is the responsibility of all managers to assure that any PC application developed in, or for, their section is documented according to the method outlined in this policy.
NOTE: This policy text is provided online for your convenience. The signed original policy document remains on file in the Division of Administration Office of Human Resources.
Contact Us
225.342.6060
P.O. Box 94095
Baton Rouge, LA 70804
1201 N. Third St., Suite 3-130
Baton Rouge, LA 70802
