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.
In my experience, the standard for paper documents is still to write out
one through ten, while the standard for web writing, which emphasizes
quick comprehension for the reader, is to use only numbers. Of course,
that's a bit of a dilemma when you're single-sourcing content for a help
system and PDF manuals.
On the web, you've got grab the attention of your reader and get your
point across quickly. After all, they can click over to Bananaphone or
Badger Badger Badger whenever they like. When someone's reading a
printed manual, you have their undivided attention.
Long live the new flesh
Chris
-----Original Message-----
From: techwr-l-bounces+cvickery=arenasolutions -dot- com -at- lists -dot- techwr-l -dot- com
[mailto:techwr-l-bounces+cvickery=arenasolutions -dot- com -at- lists -dot- techwr-l -dot- com]
On Behalf Of Sean Brierley
Sent: Tuesday, July 15, 2008 6:00 AM
To: TECHWR-L
Subject: RE: What's 1 to do?
I recommend sticking by a style guide, whether it's Chicago 14 or some
other reference text plus your own set of rules.
Cheers,
Sean
___________
Sean Brierley
Technical Writer
www.accu-time.com
-----Original Message-----
From: techwr-l-bounces+sbrierley=accu-time -dot- com -at- lists -dot- techwr-l -dot- com
I've observed an alarming tendency for the numbers 0 through 10 to be
presented as digits, rather than as written-out numbers. Stylebooks (AP
is the one I remember best without looking anything up) invariably
recommended not using digits for those small numbers except when
appropriate, as in scientific work. Now as I read articles on the web,
supposedly professionally written, I come across lonesome digits in what
feels like 2 out of every 5 cases. It looks stupid to me. Have the rules
changed while I wasn't looking?
When the hurlyburly's done,
When the battle's lost and 1.
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create HTML or Microsoft Word content and convert to Help file formats
or
printed documentation. Features include support for Windows Vista & 2007
True single source, conditional content, PDF export, modular help. Help
& Manual is the most powerful authoring tool for technical
documentation. Boost your productivity! http://www.helpandmanual.com
---
You are currently subscribed to TECHWR-L as sbrierley -at- accu-time -dot- com -dot-
True single source, conditional content, PDF export, modular help.
Help & Manual is the most powerful authoring tool for technical
documentation. Boost your productivity! http://www.helpandmanual.com
---
You are currently subscribed to TECHWR-L as cvickery -at- arenasolutions -dot- com -dot-
Create HTML or Microsoft Word content and convert to Help file formats or
printed documentation. Features include support for Windows Vista & 2007
Microsoft Office, team authoring, plus more. http://www.DocToHelp.com/TechwrlList
True single source, conditional content, PDF export, modular help.
Help & Manual is the most powerful authoring tool for technical
documentation. Boost your productivity! http://www.helpandmanual.com
---
You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-
