Document Development Life Cycle (DDLC)
The document development life cycle (DDLC) is a guideline for developing documents. The DDLC is a standard series of steps that can be specialized for any project. There are seven steps in a standard DDLC:
Every document, whether it is a two-page brochure or a 200-page user manual, must be well designed and formatted. Creative and marketing writers are expected to design new and unusual layouts. However, technical writers must design clean, predictable, coherent material in a standardized fashion. Here are some reference standards for good document design:
Glossaries contain definitions for words in the document that might be unfamiliar to the reader. Always begin a glossary on a right-hand page with a footer but not a header. Glossaries can be very difficult to write. Some words cannot be found in a dictionary or online and require extensive research by the writer. The technical writer must understand the definition of the word and then rewrite it in language the user can comprehend, at about a Grade 8 level. Do not copy phrases exactly (plagiarism). Your SME is probably not a good source for obscure definitions because he or she is a technical specialist who is given to jargon.
A good online source that incorporates many different online dictionaries is OneLook at http://www.onelook.com. If the term is an abbreviation or acronym, then use http://www.acronymfinder.com. Use major search engines, such as Google, Yahoo, and Mama, if the term is more obscure. Some searches will lead the technical writer to Request for Comments (RFCs) or standards, which are documents used in computer engineering. These documents are very technical and difficult to read but might be the only source available for some glossary terms.
Some technical writers create a company glossary that lists acceptable terminology within the organization. A company glossary is highly useful because the terms will be consistent in future projects within the same company if their definitions remain the same.
The standard requirements for a glossary are:
When the glossary is complete, give it to the editor and at least one other person for review.
A copyright marks a fixed piece of intellectual property as exclusive to its owner automatically, from the time it is created. A fixed work can be a computer file (saved or unsaved), or recorded broadcast, or printed material, or an image. An unrecorded lecture, for example, is not a fixed piece of intellectual property. An idea, title, slogan, list of ingredients, method, or concept cannot be copyrighted.
Intellectual property means published or unpublished literary, dramatic, musical, choreographed and artistic works. Examples of intellectual property include: Technical documents; architecture; movies; phonorecords (cassette tapes, CDs, vinyl disks, and MP3 audio files); novels; play scripts; sculptures; dances; pantomimes; lyrics and sheet music; and illustrations (line drawing, painting, map and photograph).
The writer might be the owner, or may have sold his or her rights to a publisher as a work-for-hire. Examples of work-for-hire include: Translations; tests and answer keys; compilations; an atlas; any collaborative work, such as an anthology or a periodical. Most technical writers perform work-for-hire. (Even if the writer sells all rights to the publisher, the writer retains moral rights under international law. This means the writer has the right of attribution and can claim authorship in a resume, for example.)
Buying a book, CD, painting, or other piece of work does not entitle you to reproduce it. If you want to photocopy or otherwise reproduce copyrighted material, you must obtain the written permission of the owner or through a Rights Management System, which grants a pay-per-use or yearly license, such as Access Copyright at http://www.accesscopyright.ca/Default.aspx?id=233. If you want to quote a reasonable passage from another writer's work in your document under "fair use" law, you must give attribution. An example of "fair use" is quoting a short passage from a book in a newspaper review. If you rely on another author's research in your document, then you must include a citation beside it, for example: (Smith, 2009). You can also give a statement, for example: "As John Smith indicated in his 2009 book, How to Count a Dog's Fleas..."
The symbol for copyright is ©, but it is also legal to print "Copyright" in full, or to abbreviate it as "Copr.". Since the Berne Convention of March, 1989, use of the copyright symbol has been optional. A copyright does not need to be officially registered to be recognized in court. However, a copyright notice gives the viewer fair warning that the work is protected and should not be reproduced without legal authorization. If a copyright notice appears at the beginning of a document and it is illegally copied, then the defendant cannot claim innocent infringement (not realizing the document is protected).
The United States protects writers whose works were created in countries that signed the Berne Convention of 1989 or The World Intellectual Property Organization Copyright Treaty of 1996. Internet and electronic work falls under the latter treaty.
New works are copyrighted for 35 years. Works made prior to 1978 have an extended copyright of 95 years. You can copyright your document online, without the aid of a lawyer or agent, through the electronic Copyright Office (eCO) at http://www.copyright.gov/ for $35. (Electronic registration is cheaper than surface mail registration.) You must subsequently deposit two hard copies of published work with the Library of Congress at 101 Independence Avenue SE in Washington, DC. You must deposit one copy of unpublished work. If you are worried that an unscrupulous person may steal your work before you finish it, you can preregister it, pursuant to the Artists' Rights and Theft Prevention Act of 2005.
If you choose to put a copyright notice at the beginning of your print document, write it this way:
© [Year of publication] [Name of copyright owner]. All rights reserved
There is no period after "All rights reserved" in a copyright notice.
If you choose to put a copyright notice at the beginning of a sound recording, write it this way:
©[Year of publication] [Name of copyright owner]
Your company lawyer determines the final placement of the copyright notice on the product and its contents. For the first draft, place the copyright notice at the beginning of your document on a separate page. Place your company's copyright notice and trademarks first. Follow your company's copyright notice with the copyrights and trademarks of any other parties or products mentioned in your document.
The trademark symbol (™) indicates that a company has officially registered a distinctive logo, symbol, sign or word with the appropriate authority. The trademark's owner places the distinctive symbol or other identifier on a product to indicate it is genuine. A trademarked symbol is restricted for use by one owner. A trademark is granted for seven to 20 years and can be renewed. An example of a famous trademarked word is Coke™, a trademark of The Coca-Cola Company.
Construct a Basic Technical Report
Change the general format for a basic technical report, below, to suit your project. A technical report should contain the following elements:
A font is a set of type in one face for all characters (letters, numbers, punctuation marks, and symbols). For example, 12-point Cambria is one font. The technical writer chooses the fonts for the project. The graphic artist must use the appropriate font for captions, so their work is consistent.
A font family is closely related typefaces that vary in weight (blackness or lightness), emphasis (roman, bold, underlined, or italic), and width (regular, condensed, or narrow). For example, Cambria is a font family and here are two individual fonts in the same family:
A serif is a tiny stroke or tail on a character that makes lengthy body text easier to read because it seems to flow together. Examples of serif fonts are Times New Roman, Garamond, and Bookman. Sans serif fonts lack the tails and are appropriate for headlines, signs, and captions. Examples of sans serif fonts are Arial Black, Lucida Sans Unicode, and Arial Narrow. Verdana is a sans serif font created for the Web.
Use no more than three different fonts in the entire document, to avoid confusion and clutter. Use italics for book titles and sparingly for emphasis. Three common fonts installed on every computer are Arial, Courier, and Times New Roman. Use these common fonts so your document is legible on most computer systems. If your reader does not own an exotic font, then the computer substitutes characters or they read as majibake garbage. Here is an example of majibake:
Incorrect tags and coding errors also result in majibake garbage in a browser.
Online Product Descriptions
A product description is a detailed report of a product or service. In addition to listing its qualities and uses, a well-written description is a sales tool that helps convince potential buyers to try a product. Most readers are already interested in the product and just need convincing information to sway their decisions. Technical writers give online product descriptions of computer software, hardware, and consumer electronics. Include these elements in every product review:
A photograph or line drawing captioned with descriptive words that highlight the look, sound, or feel of the product.
Functions and Benefits
The consumer needs to see the product's usefulness. Show the consumer how the product works and how it could streamline work or make something easier to use. Include ordering information about the product's size, weight, color, and serial or item numbers.
Reviews can sway an undecided buyer. Testimonials from current customers that list the positives about the product benefit sales. Customer reviews must be authentic to add credibility to a product. The review must illustrate how "real" people use it.
Online product descriptions contain the name of the company and the contact information for ordering (Web site, telephone number, and address), prominently displayed.
Editing Technical Writing
All professional writing requires editing by a professional editor. Editors do much more than check for grammar, spelling, and punctuation errors. Editors are also responsible for the following types of edits:
A good technical editor is organized, responsible, pays attention to detail, works well under pressure, and accommodates a variety of people. Some technical writers move on to become technical editors; their writing experience helps their success as editors.
Last Updated: 07/29/2014