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.
Ernest: runs/uses the product and documents the reality
Scribbler: believes the developer who tells him how the product should work
E: defines the outline based on what the target audience needs to accomplish
S: massages what the developer wrote (editing and formatting), without considering whether the material is relevant or not and in what sequence
E: determines what is the best way to present the material (text, table, color, illustration)
S: just writes on auto-pilot
E: strives for improvement within the timeframe allotted
S: repeats the usual 'because we've always done it like this'
E: discusses and shares with other team members
S: keeps everything to himself
E: shows genuine curiosity, appreciation and enthusiasm for the developer's work
S: endlessly whines about not getting enough SME time
E: adheres to and explains company writing standards to SMEs
S: frequently agrees with SMEs that products are special and beyond company standards
E: happy to get new assignments because of the opportunity to learn something new
S: documenting the 275th version of the product he knows makes him happy
E: performs the admin aspects of the job
S: explains why he didn't
HTH,
Erika Yanovich
Manager, Technical Documentation Dept.
T: +972-3-645-8163 | F: +972-3-649-8250 | erika_y -at- rad -dot- com
RAD Data Communications Ltd., 24, Raoul Wallenberg St., Tel-Aviv 69719, Israel | www.rad.com
Gain access to everything you need to create and publish information
through multiple channels. Your choice of authoring (and import)
formats with virtually any output. Try Doc-To-Help free for 30-days. http://www.doctohelp.com/
---
You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-