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.
Question about book not keeping to Writing dept. style guide
Subject:Question about book not keeping to Writing dept. style guide From:"Caroline Tabach" <caroline -dot- tabach -at- gmail -dot- com> To:techwr-l -at- lists -dot- techwr-l -dot- com Date:Mon, 18 Dec 2006 12:12:42 +0200
Our writing dept has a style guide made over the years by our managers
and added to by various writers (i.e. although I do not have specific
sources to say why one usage is better than another, this is how all
our books are written).
When I was on maternity leave one of the user guides was outsourced
and while they did use our FrameMaker template, they did not use our
style guide.
As a result many things appear differently in this guide than in our
other guides.
This guide is not a "one-off" guide but for a product being updated.
The types of things that are different here are:
*a different table style is used
*There are table titles (which we do not have in our other guides)
*A lot of quotations marks are used while our style guide calls for
using italics instead of quotation marks as much as possible.
*The way tables, and dialog boxe are introduced is different.
Except for the quotation marks Vs italics I do not think anything here
is wrong usage, but they just make this book different from all of our
other books.
The question is, should I ask one of the writers here to go through
the book and make the appropriate changes so it conforms to our style
guide. I am hesitant because quite a lot of work is involved
especially replacing all of the quotation marks used.
WebWorks ePublisher Pro for Word features support for every major Help
format plus PDF, HTML and more. Flexible, precise, and efficient content
delivery. Try it today! http://www.webworks.com/techwr-l
Create HTML or Microsoft Word content and convert to Help file formats or
printed documentation. Features include single source authoring, team authoring,
Web-based technology, and PDF output. http://www.DocToHelp.com/TechwrlList