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.
re: I have to agree with Richard Smith and Andrew Plato, content is more
important than format.
Sure, but content is 51% and format is 49%, isn't it?
Seems a bit an irrelevant discussion since it's the subject matter experts'
responsibility to verify adequacy and completeness of content and it's the
tech writer's responsibility to ensure readability, i.e. create the best
format. This is a list for tech writers--yes 49% means we are "support" but
where's the problem in that?
Next time you fly consider whether your pilot has a pile of engineering
drawings to pore through (the content is all there ... somewhere) or some
ergonomically designed checklists to reference. Others can provide more
examples where format can be pretty important.
Best things to "benchmark" as regards this discussion are the successful
teaming of the tech writer and the product designer and then whether the
reader "gets it." But not "gets it eventually" and not "we're not liable
because it was 'in there,'" but gets it as needed and as required and
usefully, easily, successfully, accurately, safely, etc.
Tech writing is important and you let "format" slide at your peril.
*** Deva(tm) Tools for Dreamweaver and Deva(tm) Search ***
Build Contents, Indexes, and Search for Web Sites and Help Systems
Available now at http://www.devahelp.com or info -at- devahelp -dot- com
Learn about tools and technologies for user assistance developers at
The Help Technology Conference, August 21-24 in Boston, MA
Details and online registration at http://www.SolutionsEvents.com
---
You are currently subscribed to techwr-l as: archive -at- raycomm -dot- com
To unsubscribe send a blank email to leave-techwr-l-obscured -at- lists -dot- raycomm -dot- com
Send administrative questions to ejray -at- raycomm -dot- com -dot- Visit http://www.raycomm.com/techwhirl/ for more resources and info.