Re: Sloppy writing, sloppy thinking

Subject: Re: Sloppy writing, sloppy thinking
From: "Bonnie Granat" <bgranat -at- editors-writers -dot- info>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Wed, 28 May 2003 22:57:48 -0400



----- Original Message -----
From: "Bruce Byfield" <bbyfield -at- axionet -dot- com>
: But I also mean to say that, if you knew nothing about the topic at all,
: you might think that they gave you a good understanding of what was
: being discussed. However, when you look closely, with the software and
: hardware in front of you, you soon see that the writing isn't as clear
: as it seems. Also, while it isn't exactly wrong, it's at a very high
: level of generality, so that the uninitiated could easily come away with
: the wrong ideas about the relations between the parts and how the whole
: worked. I think that this quality explains why the material slipped past
: its reviewers: they obviously didn't validate wha tthe were reviewing
: because it seemed plausible at a moderately superficial level.
:

Sounds like what I encounter in Microsoft documentation, for the most part.
Even in their documents that purport to solve problems online. Makes me shiver
just to think about it.

___________________________________
Bonnie Granat
Granat Editorial Services
http://www.editors-writers.info




^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Robohelp X3, from eHelp, lets you quickly and easily create
professional Help systems for all your Windows and Web-based
applications, including Net.

Order RoboHelp X3 in May and receive a $100 mail-in rebate, PLUS
free RoboScreenCapture and WebHelp Merge Module.

Order RoboHelp today: http://www.ehelp.com/techwr-l

---
You are currently subscribed to techwr-l as:
archive -at- raycomm -dot- com
To unsubscribe send a blank email to leave-techwr-l-obscured -at- lists -dot- raycomm -dot- com
Send administrative questions to ejray -at- raycomm -dot- com -dot- Visit
http://www.raycomm.com/techwhirl/ for more resources and info.



Follow-Ups:

References:
Re: You're SUPPOSED to have good communication skills if you're a tech writer: From: Jan Henning
Re: You're SUPPOSED to have good communication skills if you're a tech writer: From: Bruce Byfield
Sloppy writing, sloppy thinking: From: Michael West
Re: Sloppy writing, sloppy thinking: From: Bruce Byfield

Previous by Author: Re: Certification List
Next by Author: Re: How to handle when the scope changes?
Previous by Thread: Re: Sloppy writing, sloppy thinking
Next by Thread: Re: Sloppy writing, sloppy thinking


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


Sponsored Ads