TechWhirl (TECHWR-L) is a resource for technical writing and technical communications professionals of all experience levels and in all industries to share their experiences and acquire information.
For two decades, technical communicators have turned to TechWhirl to ask and answer questions about the always-changing world of technical communications, such as tools, skills, career paths, methodologies, and emerging industries. The TechWhirl Archives and magazine, created for, by and about technical writers, offer a wealth of knowledge to everyone with an interest in any aspect of technical communications.
>Has anyone heard the term "evergreen document"?
>
>i.e., ...the manual [...] should be maintained as an evergreen document"
Yes. It is used to refer to a document that covers all versions of a
product, not just the current version. Thus when a new version is created,
material is added to the document to cover that version, rather than the
document being revised to cover that version alone. Such documents are
considered useful in situations where a product, such as a telephone switch,
may be in service for many years after new versions are released, and where
service personnel may have to deal with many different vintages of the
product. With an evergreen document they can deal with only one document for
all the systems they service, instead of one for each. Also, an evergreen
document can deal with product differences in both directions and answer
such questions as "in which version did they introduce feature x".
Needless to say, evergreen documents are very difficult to produce and
maintain without a good content management system.
---
Mark Baker
Manager, Corporate Communications
OmniMark Technologies Corporation
1400 Blair Place
Gloucester, Ontario
Canada, K1J 9B8
Phone: 613-745-4242
Fax: 613-745-5560
Email mbaker -at- omnimark -dot- com
Web: http://www.omnimark.com