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.
You're telling an exciting story.
Nancy Allison wrote:
> I have been asked to put on a marketing writer's hat and write some stuff for the web site.
> I am a tech writer in my bones and want nothing more than to give people the information they need as concisely (not to say *tersely*) as possible. I'm all about figuring out doc structure, page structure, topic structure, sentence structure, with associated headings and keywords and formatting so people can find what they need and recognize when they've found it.
> Marketing is a related but definitely foreign language.
> I've been down this path once before and crashed into the prickerbushes much too soon.
> "It's too list-y,' grumbled my manager. "You've got a header, then a sentence-and-a-list, then a new header, then a sentence-and-a-list . . . that's not marketing writing."
> I kinda got what he meant. I used bulleted lists because, for busy users who are trying to get their work done, that's what makes info pop out. (Yes, I know, tables, too. You get my drift: Terse and pared to the bone and organized to make key topics obvious.)
> But marketing pieces, on the company web site, are trying to lure someone into a relationship with the product, right? They're more in seduction mode. Correct?
> Please don't get hung up on the listy bit -- I have some marketing pieces in front of me and I do see bulleted lists hither and yon, but they do also have more of a conversational feel. I think that's the difference.
> What advice would you give a tech writer who wants to do better this time? What's the difference, after all? When you put on your Marketing writer hat, how do you write differently?
> Any suggestions gratefully received.
626 444-5112 office
626 840-8875 cell
ComponentOne Doc-To-Help 2009 is your all-in-one authoring and publishing
solution. Author in Doc-To-Help's XML-based editor, Microsoft Word or
HTML and publish to the Web, Help systems or printed manuals. http://www.doctohelp.com
Help & Manual 5: The complete help authoring tool for individual
authors and teams. Professional power, intuitive interface. Write
once, publish to 8 formats. Multi-user authoring and version control! http://www.helpandmanual.com/
You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-