RE: been asked for advice by "non-writers"?

Subject: RE: been asked for advice by "non-writers"?
From: "Sarah Blake" <Sarah -dot- Blake -at- nice -dot- com>
To: "techwr-l" <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Tue, 6 Nov 2012 16:57:10 +0000

> Have you been asked for writing advice by an engineer, a developer, or some other SME? If so, what sort of advice were they looking for?

A new member of Support was referred to me for writing advice; her seniors had asked her to write a troubleshooting document, but didn't like her initial couple of drafts so pointed her in my direction.

I reviewed the latest draft of the document, sat down with her to discuss technical writing best practices and the reasons behind them, and... discovered that that was the way she'd written her initial draft, and that her bosses had insisted on changes that made the document less clear and worse structured. After a bit of three-way back-and-forth, we updated the Word styles she was using, slapped a prettier cover on the front, and the result was accepted without any changes in structure or content.

I died a little bit inside.

In fact, mostly I find that SMEs only consult me to get the latest corporate template or troubleshoot Word style issues.

Sarah Blake
Senior Technical Writer
+44 1344 86 5123

NICE - Intent. Insight. Impact.TM

Merced Systems Limited ("Merced"), now a part of NICE Systems Ltd., is registered in England under company number, 03386264. The registered office of Merced is Tollbar Way, Hedge End, Southampton, Hampshire SO30 2ZP.
Confidentiality: This communication and any attachments are intended for the above-named persons only and may be confidential and/or legally privileged. Any opinions expressed in this communication are not necessarily those of Merced. If this communication has come to you in error you must take no action based on it, nor must you copy or show it to anyone; please delete/destroy and inform the sender by e-mail immediately.

Monitoring: Merced may monitor incoming and outgoing e-mails.
Viruses: Although we have taken steps toward ensuring that this e-mail and attachments are free from any virus, we advise that in keeping with good computing practice the recipient should ensure they are actually virus free.

Writer Tip: Create 10 different outputs with Doc-To-Help -- including Mobile and EPUB.

Read all about them:

You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-

To unsubscribe send a blank email to
techwr-l-leave -at- lists -dot- techwr-l -dot- com

Send administrative questions to admin -at- techwr-l -dot- com -dot- Visit for more resources and info.

Looking for articles on Technical Communications? Head over to our online magazine at

Looking for the archived Techwr-l email discussions? Search our public email archives @


been asked for advice by "non-writers"?: From: Milan Davidović

Previous by Author: Re: "Term Mining" -- Any tips or tools for small-scale job?
Next by Author: RE: living with the vernacular (was RE: Beliefs and passions- newjob requirements
Previous by Thread: Re: been asked for advice by "non-writers"?
Next by Thread: Re: been asked for advice by "non-writers"?

What this post helpful? Share it with friends and colleagues:

Sponsored Ads