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.
> Since both options are viable, I'd send an email message to both SMEs
> asking them to decide upon a convention. That way you have their
> in writing in case they change opinions later. Also, you can get them
> talk to each other so that you aren't stuck acting as a middle-man in
> decision making process.
I meant to put in my 2 cents when I saw Spectrum Writing's "playing
Switzerland" line. Why is the tech writer "playing Switzerland" in a
matter of language usage? Doesn't the tech writer _write_ the docs?
I'd send an email message to both SMEs _informing_ them of _my_
decision, and telling them it's been added to the style guide (for which
Tech Pubs is responsible, not SMEs).
SME stands for "subject matter expert" -- not "technical communication
expert." Once the subject matter issues are clear and the meanings of
the two words are understood, the decision should be the wordsmith's.
Unless he or she _likes_ being a glorified secretary.
"It's my opinion and it's very true."
Richard G. Combs
Senior Technical Writer
richardDOTcombs AT polycomDOTcom
rgcombs AT gmailDOTcom
ComponentOne Doc-To-Help 2009 is your all-in-one authoring and publishing
solution. Author in Doc-To-Help's XML-based editor, Microsoft Word or
HTML and publish to the Web, Help systems or printed manuals. http://www.doctohelp.com
Help & Manual 5: The complete help authoring tool for individual
authors and teams. Professional power, intuitive interface. Write
once, publish to 8 formats. Multi-user authoring and version control! http://www.helpandmanual.com/
You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-