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.
> I was taught in a technical writing course many years ago to avoid "to be"
> in technical writing. Now that I avoid it, I cringe when I see it. "To be"
> is promissory, predictive, and passive. It is not "passive voice" it
> passive or a passive sense, like timid. "To be" is not in the moment and it
> asks the reader to wait for some future event or to reflect on some other
> option. Technical writing should address the matter at hand, so for that,
> "to be" should be avoided. Proposal writing should be assertive and "to be"
> is timid.
>
> For the example here, "the directory will be created," I would say the
> "the system will create the directory," to avoid a passive sense that is
> not necessarily a passive voice.
>
>
> On 8/7/2017 3:11 PM, Robert Lauriston wrote:
>
>> Future tense is sometimes appropriate. "If the specified output
>> directory does not exist, it will be created automatically."
>>
>> On Mon, Aug 7, 2017 at 2:58 PM, Peter Neilson <neilson -at- windstream -dot- net>
>> wrote:
>>
>>> It is usually good to avoid future tense when documenting the
>>> capabilities
>>> of a product. ...
>>>
>>
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
> Visit TechWhirl for the latest on content technology, content strategy and
> content development | http://techwhirl.com
>
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> You are currently subscribed to TECHWR-L as usha -dot- manoj07 -at- gmail -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
>
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Visit TechWhirl for the latest on content technology, content strategy and content development | http://techwhirl.com