"Bad" documentation examples

Subject: "Bad" documentation examples
From: Ryan Young <ryangyoung -at- gmail -dot- com>
To: tech2wr-l <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Mon, 23 Nov 2015 21:38:32 -0800

Hi everyone,

I'm putting together a presentation to help developers contribute to the
documentation. Part of the presentation is general writing guidelines, like
"use the active voice," "write in the present tense," "avoid ambiguous
pronouns," keep things short"--all the usual suggestions. For this section,
we'd like to provide some examples of the "bad" way to do things. There is
obviously no shortage of these things and I'm going to try to cull as many
as possible from our own docs, but, thankfully, what we do have is not that
bad.

So, if you have any of these "bad" examples, please send them my way!

Thanks,
Ryan
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Visit TechWhirl for the latest on content technology, content strategy and content development | http://techwhirl.com

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

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:

Previous by Author: Re: Information trumps matter
Next by Author: Re: Re: Re: FrameMaker does NOT update links . . . .
Previous by Thread: Re: formatting - internal links versus external links
Next by Thread: Re: "Bad" documentation examples


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


Sponsored Ads