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

Syed Zaeem Hosain Syed.Hosain at aeris.net
Wed Jun 1 00:03:39 PDT 2016


> From Bernard Aschwanden (Publishing Smarter)
> 
> I'll chime in to say that in almost every case where people create content, it should be done with the audience in mind. Unless the audience knows "exemplified" it's likely best to stick to ideas other people have suggested.
> 
> Simpler is often better. It's becoming more and more common for people who read content to have a background that may not be "English first". That's a good reason to stick to words they know best. The content we create isn't (or generally *shouldn't*) be a way to show how clever we are with words, but rather how clever we are with making people not even think about the words and instead help them achieve their goals with no obstacles.

Agreed!

This definition: http://www.dictionary.com/browse/exemplified says that the difficulty index for "exemplify/exemplified" is higher than other words, and "Few English speakers likely know this word."

A synonym: http://www.dictionary.com/browse/example shows a lower difficulty index for "example", and "Most English speakers likely know this word."

So, yes, KISS applies.

Z


More information about the Framers mailing list