Re: Footnotes - acceptable in technical documentation?

Subject: Re: Footnotes - acceptable in technical documentation?
From: Milan Davidović <milan -dot- lists -at- gmail -dot- com>
To: "Bruce Megan (ST-CO/MKP3)" <Megan -dot- Bruce -at- us -dot- bosch -dot- com>
Date: Fri, 8 Nov 2013 13:26:44 -0500

What's sort of technical documentation is it, who's reading/using it.
and what are they accustomed to seeing?

Here's a research idea; sample some tech doc from a defined
"population" (genre, I suppose) and see what sorts of things it does
(and doesn't) include (e.g. footnotes).

--Milan DavidoviÄ

Sent from my Yost 10


On Fri, Nov 8, 2013 at 11:33 AM, Bruce Megan (ST-CO/MKP3)
<Megan -dot- Bruce -at- us -dot- bosch -dot- com> wrote:
> Hello All:
>
> What are you thoughts on footnotes in technical documentation? I have been told that footnotes in technical documentation is forbidden because instructions show the reader how to do something, and footnotes distract the reader from instruction.
>
> Your thoughts?


^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
New! Doc-to-Help 2013 features the industry's first HTML5 editor for authoring.

Learn more: http://bit.ly/ZeOZeQ

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

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


References:
Footnotes - acceptable in technical documentation?: From: Bruce Megan (ST-CO/MKP3)

Previous by Author: Re: So now we are content engineers?
Next by Author: Re: So now we are content engineers?
Previous by Thread: Re: Footnotes - acceptable in technical documentation?
Next by Thread: TechWhirl: Technical Communication Recap for November 8, 2013


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


Sponsored Ads