TechWhirl Sponsors

About TechWhirl

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.

Re: listing "credits" in a manual

I always put complete credits in manuals. For one thing, it got my name
plastered all over everything. For another, it made hiring easier. Tech
writers rarely get recognition, and here I was giving credit where
credit is due in black and white. But perhaps the best advantage of
having credits was that all the people who coughed up content for the
manual got their names in print. The reaction of the engineers and
technicians to getting their name in print was overwhelmingly positive.

I put credits on the inside front cover, after the title and copyright
information, but before the trademark boilerplate and corporate address.
This makes the credits findable but ignorable.

When people asked if credits were a proper corporate procedure, I always
said, "Of course they are. Really widely distributed documents, like
journal papers, trade magazine articles, and annual reports, always
have credits. In other documentation, some companies give credit,
and some don't. But if they don't, it's just laziness. If they give
credit in the annual report, it can't possibly be un-corporate to
give credit."