Re: passive voice (was RE: Numbering paragraphs

Subject: Re: passive voice (was RE: Numbering paragraphs
From: sphilip <philstokes03 -at- googlemail -dot- com>
To: Chris Despopoulos <despopoulos_chriss -at- yahoo -dot- com>
Date: Mon, 22 Oct 2012 20:56:23 +0700

We can go round in circles like this for ever.

So let's agree that we disagree on this. You claim:

> if the agent is unknown to you, you're not doing your job.

whereas I claim:

if you mention the agent to the reader when the reader has no interest in the agent, you're not doing your job properly.

I should certainly know what causes actions in the system I am documenting. It doesn't follow from that that mentioning the agent is always in the reader's best interest.


Best

Phil
http://applehelpwriter.wordpress.com

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Writer Tip: You have more time to author content with Doc-To-Help, because your project can be up and running in 3 steps.

See the &#8220;Getting Started with Doc-To-Help&#8221; blog post. http://bit.ly/doc-to-help-3-steps
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

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
http://www.techwhirl.com/email-discussion-groups/ for more resources and info.

Looking for articles on Technical Communications? Head over to our online magazine at http://techwhirl.com

Looking for the archived Techwr-l email discussions? Search our public email archives @ http://techwr-l.com/archives


Follow-Ups:

References:
Re: passive voice (was RE: Numbering paragraphs: From: Chris Despopoulos
Re: passive voice (was RE: Numbering paragraphs: From: Milan Davidović
Re: passive voice (was RE: Numbering paragraphs: From: Chris Despopoulos
Re: passive voice (was RE: Numbering paragraphs: From: sphilip
Re: passive voice (was RE: Numbering paragraphs: From: Chris Despopoulos
Re: passive voice (was RE: Numbering paragraphs: From: sphilip
Re: passive voice (was RE: Numbering paragraphs: From: Chris Despopoulos

Previous by Author: Re: passive voice (was RE: Numbering paragraphs
Next by Author: Re: passive voice (was RE: Numbering paragraphs
Previous by Thread: Re: passive voice (was RE: Numbering paragraphs
Next by Thread: Re: passive voice (was RE: Numbering paragraphs


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


Sponsored Ads