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: Seeking advice on the best way to phrase an error message?
Subject:Re: Seeking advice on the best way to phrase an error message? From:"Mike Starr" <mikestarr-techwr-l -at- writestarr -dot- com> To:<HBacheler -at- aol -dot- com>, <ghart -at- videotron -dot- ca>, <techwr-l -at- lists -dot- techwr-l -dot- com>, <ipsque -at- yahoo -dot- com> Date:Fri, 30 Mar 2007 22:03:36 -0500
Almost all current development environments allow the programmer to insert
the punctuation of choice in a phone number field or Social Security number
field so that all the user needs to do is type the numbers; the punctuation
is just ignored.
Mike
--
Mike Starr WriteStarr Information Services
Technical Writer - Online Help Developer - Website developer
Graphic Designer - Desktop Publisher - MS Office Expert
Phone: (262) 694-1028 - Tollfree: (877) 892-1028 - Fax:(262) 697-6334
Email: mike -at- writestarr -dot- com - Web: http://www.writestarr.com
----- Original Message -----
From: <HBacheler -at- aol -dot- com>
To: <ghart -at- videotron -dot- ca>; <techwr-l -at- lists -dot- techwr-l -dot- com>; <ipsque -at- yahoo -dot- com>
Sent: Friday, March 30, 2007 8:38 PM
Subject: Re: Seeking advice on the best way to phrase an error message?
>A reasonable 'default for the phone number is area code, central office,
> instrument/instruments number.
>
> for example a minimal phone number entry in the field is 8005551212.(10
> digits)
> No punctuation, separation, hidden meaning
>
> Social security number 123456789 (9 digits)
>
> I think any programmer/designer/analyst should accept this as the
> optimum.
>
> There is NO DIFFERENT way you can express either of these numbers in their
> minimum form
>
> You can have 800-555-1212 - (800)555-1212 - (800) 555-1212 - 800.555.1212
>
> You can have 123-45-6789
>
> The dash) -, the open parenthesis (, and the close parenthesis ) are
> values
> that can be 'skipped' in the parsing/verificatin/validation of the
> number.
>
> So "I" forgot the punctuation, so what, (programmer/analyst/designer) deal
> with it in your design and implementation...
>
> Bringing back my days as a programmer/analyst/designer --- making things
> easier for the customer.
>
> Other input?
>
> Harry
Create HTML or Microsoft Word content and convert to Help file formats or
printed documentation. Features include single source authoring, team authoring,
Web-based technology, and PDF output. http://www.DocToHelp.com/TechwrlList
Now shipping: Help & Manual 4 with RoboHelp(r) import! New editor,
full Unicode support. Create help files, web-based help and PDF in up
to 106 languages with Help & Manual: http://www.helpandmanual.com
---
You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-