[Framers] "Exemplified" - use in technical documentation?

[Art Campbell]

Second Peter's "show in."



Art Campbell
          art.campbell at gmail.com
  "... In my opinion, there's nothing in this world beats a '52 Vincent and
a redheaded girl." -- Richard Thompson
                                                      No disclaimers apply.
                                                               DoD 358


On Tue, May 31, 2016 at 1:00 PM, Peter Hirons <peter at galley.ie> wrote:

> Get rid of it - it's just pompous writing.  Especially important if your
> documents go to non-native-English speakers.
>
> "Shown in" is universally understood. "Illustrated in" less so.
>
> ---
>
>
> Peter
>
>
> On 2016-05-31 17:50, Stephen O'Brien wrote:
>
>> Hi,
>>
>> A new technical writer uses « exemplified in Fig. X.X» in captions to
>> describe images in our technical reference documentation for a quality
>> control software.
>>
>> I have asked that a simpler synonym be used (shown in Figure X.X).
>>
>> I consider that "exemplified" is not a commonly used term (I haven't
>> heard or read the term in years) and is not easily read. The writer
>> does not want to give the term up, considering it equal to
>> "illustrated in".
>>
>> What do you think?
>>
>> Stephen O'BRIEN
>> Coordonnateur de la qualité documentaire et rédacteur technique senior
>> | Quality Coordinator for Documentation and Senior Technical Writer
>> InnovMetric Logiciels | Software
>> sobrien at innovmetric.com<mailto:sobrien at innovmetric.com>
>> T (1) 418.688.2061
>> F (1) 418.688.3001
>> [cid:image001.gif at 01D1BB3B.06299CB0]<http://www.innovmetric.com/>
>> AVIS DE CONFIDENTIALITÉ/CONFIDENTIALITY NOTICE: Ce message peut
>> contenir des renseignements confidentiels appartenant exclusivement à
>> InnovMetric Logiciels inc. ou à ses filiales. Si vous n'êtes pas le
>> destinataire indiqué dans ce message (ou responsable de livrer ce
>> message à la personne indiquée ou prévue) ou si vous pensez que ce
>> message vous a été adressé par erreur, vous ne pouvez pas utiliser ou
>> reproduire ce message, ni le livrer à quelqu'un d'autre. Dans ce cas,
>> veuillez le retourner à l'expéditeur et le détruire. Proprietary
>> confidential information belonging to InnovMetric Software Inc. and
>> its affiliates may be contained in this message. If you are not a
>> recipient indicated or intended in this message (or responsible for
>> delivering this message to such a person), or you think for any reason
>> that this message may have been addressed to you by mistake, you may
>> not use or copy this message, or deliver it to anyone else. In which
>> case, notify the sender and destroy the e-mail.
>>
>>
>> _______________________________________________
>>
>> This message is from the Framers mailing list
>>
>> Send messages to framers at lists.frameusers.com
>> Visit the list's homepage at  http://www.frameusers.com
>> Archives located at
>> http://www.mail-archive.com/framers%40lists.frameusers.com/
>> Subscribe and unsubscribe at
>> http://lists.frameusers.com/listinfo.cgi/framers-frameusers.com
>> Send administrative questions to listadmin at frameusers.com
>>
> _______________________________________________
>
> This message is from the Framers mailing list
>
> Send messages to framers at lists.frameusers.com
> Visit the list's homepage at  http://www.frameusers.com
> Archives located at
> http://www.mail-archive.com/framers%40lists.frameusers.com/
> Subscribe and unsubscribe at
> http://lists.frameusers.com/listinfo.cgi/framers-frameusers.com
> Send administrative questions to listadmin at frameusers.com
>