RE: AuthorIt Message 43

Subject: RE: AuthorIt Message 43
From: "Beth Sargent" <beth -dot- sargent -at- syncvoice -dot- com>
To: <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Thu, 29 Mar 2007 08:05:11 -0700

Hi Jennifer,

Does AuthorIt have color depth settings? If so you may want to increase
the depth and then save the image (thus saving all colors in the
palette). This is actually the way it works in SnagIt and it may be
different in AuthorIt, but a similar option may exist.

Good luck!

Beth Sargent
SyncVoice Communications
beth -dot- sargent -at- syncvoice -dot- com
714-901-1445 ext. 2137
www.syncvoice.com

-----Original Message-----
From: techwr-l-bounces+beth -dot- sargent=syncvoice -dot- com -at- lists -dot- techwr-l -dot- com
[mailto:techwr-l-bounces+beth -dot- sargent=syncvoice -dot- com -at- lists -dot- techwr-l -dot- com]
On Behalf Of techwr-l-request -at- lists -dot- techwr-l -dot- com
Sent: Wednesday, March 28, 2007 11:00 PM
To: techwr-l -at- lists -dot- techwr-l -dot- com
Subject: TECHWR-L Digest, Vol 17, Issue 29

Send TECHWR-L mailing list submissions to
techwr-l -at- lists -dot- techwr-l -dot- com

To subscribe or unsubscribe via the World Wide Web, visit
http://lists.techwr-l.com/mailman/listinfo/techwr-l
or, via email, send a message with subject or body 'help' to
techwr-l-request -at- lists -dot- techwr-l -dot- com

You can reach the person managing the list at
techwr-l-owner -at- lists -dot- techwr-l -dot- com

When replying, please edit your Subject line so it is more specific
than "Re: Contents of TECHWR-L digest..."


^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
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 &amp; 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 &amp; Manual: http://www.helpandmanual.com

---


Today's Topics:

1. RE: Writing a proposal: Proper tense for actions not yet
finalized? (Dori Green)
2. RE: Example of quality technical writing: coding style
(Dan Goldstein)
3. Re: Giving up on XML (Chris Borokowski)
4. Re: employed again, not writing... (Chris Borokowski)
5. Legal requirements for document accessibility. (Kate Salm)
6. RE: Getting Black Balled by a Doc Manager & Filing for
Unemployment-Need Advice (Dori Green)
7. Questions About Arbortext. (richard -dot- melanson -at- us -dot- tel -dot- com)
8. RE: Boss key (Dori Green)
9. RE: What is an engineering department and what does it do?
(Dori Green)
10. ADMIN: Please, let's keep it on track (TECHWR-L Administrator)
11. Legal requirements for document accessibility? (Geoff Hart)
12. RE: Getting Black Balled by a Doc Manager & Filing
forUnemployment-Need Advice (Mark Barrera - Tech Writer)
13. RE: Legal requirements for document accessibility? (Kate Salm)
14. Re: Legal requirements for document accessibility.
(Char James-Tanny)
15. RE: Boss key (John Posada)
16. RE: Legal requirements for document accessibility. (Kate Salm)
17. RE: Boss key (Melissa Nelson)
18. Re: Legal requirements for document accessibility?
(Hemanth Basrur)
19. what is authentic assessment about and how is it used in
technical communication (technical writing plus)
20. Re: Legal requirements for document accessibility?
(stevefjong -at- comcast -dot- net)
21. RE: what is authentic assessment about and how is it used in
technicalcommunication (Combs, Richard)
22. Re: Unimployment in Texas (David Neeley)
23. Re: what is authentic assessment about and how is it used in
technical communication (Milan Davidovic)
24. Re: what is authentic assessment about and how is it used in
technical communication (Milan Davidovic)
25. Re: what is authentic assessment about and how is it used in
technical communication (Milan Davidovic)
26. duplicate posts from me? (Milan Davidovic)
27. The cost of inaccurate technical documentation (Dan Goldstein)
28. RoboHelp: WinHelp: TOC not Updating (Keith Hansen)
29. Re: RoboHelp: WinHelp: TOC not Updating (Pro TechWriter)
30. Re: The cost of inaccurate technical documentation (John Posada)
31. RE: The cost of inaccurate technical documentation (Dan Goldstein)
32. RE: The cost of inaccurate technical documentation (John Posada)
33. RE: The cost of inaccurate technical documentation (Dan Goldstein)
34. Re: The cost of inaccurate technical documentation (Gene Kim-Eng)
35. RE: The cost of inaccurate technical documentation
(technical writing plus)
36. Re: The cost of inaccurate technical documentation
(elizabeth j allen)
37. Re: The cost of inaccurate technical documentation (John Posada)
38. RE: The cost of inaccurate technical documentation (Poshedly, Ken)
39. RE: The cost of inaccurate technical documentation (John Posada)
40. Re: The cost of inaccurate technical documentation (Guy K. Haas)
41. Re: Questions About Arbortext. (Janice Gelb)
42. Re: Giving up on XML (Janice Gelb)
43. AuthorIT: Poor image quality for screen captures
(Jennifer Baldwin)
44. WinHelp: Default Topic, TOC, or Index Displayed? (Keith Hansen)
45. Yahoo Groups e-mail gone crazy? (Guy K. Haas)
46. Re: Yahoo Groups e-mail gone crazy? (ArroxaneUllman -at- aol -dot- com)
47. Re: Questions About Arbortext. (quills -at- airmail -dot- net)
48. Re: Questions About Arbortext. (Paul Nagai)


----------------------------------------------------------------------

Message: 1
Date: Wed, 28 Mar 2007 08:43:49 -0400
From: "Dori Green" <dgreen -at- associatedbrands -dot- com>
Subject: RE: Writing a proposal: Proper tense for actions not yet
finalized?
To: <techwr-l -at- lists -dot- techwr-l -dot- com>
Message-ID: <HFEFKEECOFNMGKOMDFLPGEOPCIAA -dot- dgreen -at- associatedbrands -dot- com>
Content-Type: text/plain; charset="us-ascii"

I also strongly recommend present tense and active voice. They tend to
be:

a. more concise

b. easier to read

c. like the truth, easier to keep track of

Come to think of it, this is another good detail to add to our company
style
guide.

Dori Green



------------------------------

Message: 2
Date: Wed, 28 Mar 2007 08:49:14 -0400
From: "Dan Goldstein" <DGoldstein -at- riverainmedical -dot- com>
Subject: RE: Example of quality technical writing: coding style
To: <techwr-l -at- lists -dot- techwr-l -dot- com>
Message-ID:
<0ADA9A22B5BC2147B360A22FD2BAD25CA916AB -at- RMGBEX01 -dot- rmg -dot- local>
Content-Type: text/plain; charset="us-ascii"

You just quoted a developer I know almost word-for-word.

ROFGFO (Rolling on the floor gasping for oxygen),

Dan

> -----Original Message-----
> From: Andrew Warren
> Sent: Tuesday, March 27, 2007 6:23 PM
> To: Chris Borokowski; techwr-l -at- lists -dot- techwr-l -dot- com
> Subject: RE: Example of quality technical writing: coding style
>
> ... Saying that these superficial formatting details can
> significantly improve the maintainability of a program is like
> saying "If everyone used the 'Chapter-Page' page-numbering
> method, and labeled list items with letters rather than numbers,
> and set the left margin to exactly one inch, and used British
> English spelling... Technical documents would be much easier to
> read and maintain..."
>

This message contains confidential information intended only for the use
of the addressee(s). If you are not the addressee, or the person
responsible for delivering it to the addressee, you are hereby notified
that reading, disseminating, distributing, copying, electronic storing
or the taking of any action in reliance on the contents of this message
is strictly prohibited. If you have received this message by mistake,
please notify us, by replying to the sender, and delete the original
message immediately thereafter. Thank you.



------------------------------

Message: 3
Date: Wed, 28 Mar 2007 05:57:10 -0700 (PDT)
From: Chris Borokowski <athloi -at- yahoo -dot- com>
Subject: Re: Giving up on XML
To: techwr-l -at- lists -dot- techwr-l -dot- com
Message-ID: <182985 -dot- 22512 -dot- qm -at- web57807 -dot- mail -dot- re3 -dot- yahoo -dot- com>
Content-Type: text/plain; charset=iso-8859-1

I don't think the odds going down originates in the
document being structured as much as that it's people
finally paying attention to document structure. In my
mind, the fundamental advantage of structure in
documentation is portability, and that's going to be
the biggest new task for writers in this age. The same
text is going to show up in marketing brochures, web
pages, online help, printed help, keynote speeches,
phone support and probably direct mail, because good
text is hard to develop and there's (apparently) a
shortage of college-educated, willing help to write
it.

(FYI, the education is their requirement, not mine.)

--- Janice Gelb <janice -dot- gelb -at- sun -dot- com> wrote:

> I agree that writers can still produce badly
> organized documentation even in a structured
> authoring environment but the odds do go down.


User Interface design blog
http://user-advocacy.blogspot.com/
Code::Design::UI::Consulting
http://www.dionysius.com/



________________________________________________________________________
____________
Be a PS3 game guru.
Get your game face on with the latest PS3 news and previews at Yahoo!
Games.
http://videogames.yahoo.com/platform?platform=120121


------------------------------

Message: 4
Date: Wed, 28 Mar 2007 05:58:12 -0700 (PDT)
From: Chris Borokowski <athloi -at- yahoo -dot- com>
Subject: Re: employed again, not writing...
To: techwr-l -at- lists -dot- techwr-l -dot- com
Message-ID: <446541 -dot- 23350 -dot- qm -at- web57807 -dot- mail -dot- re3 -dot- yahoo -dot- com>
Content-Type: text/plain; charset=iso-8859-1

I wouldn't give up. Most things fail before they
succeed. If you know you can do it, you can. Even a
half-hour a week can achieve results.

Best of luck.

--- "D. Michael McIntyre"
<michael -dot- mcintyre -at- rosegardenmusic -dot- com> wrote:

> I'm driving a truck once more, and this is
> eating so much time I
> figure that's about all she wrote for this attempt
> at a brave new world.

User Interface design blog
http://user-advocacy.blogspot.com/
Code::Design::UI::Consulting
http://www.dionysius.com/



________________________________________________________________________
____________
Be a PS3 game guru.
Get your game face on with the latest PS3 news and previews at Yahoo!
Games.
http://videogames.yahoo.com/platform?platform=120121


------------------------------

Message: 5
Date: Wed, 28 Mar 2007 13:27:47 +0000
From: Kate Salm <catrose15 -at- hotmail -dot- com>
Subject: Legal requirements for document accessibility.
To: <techwr-l -at- lists -dot- techwr-l -dot- com>
Message-ID: <BAY128-W1474999F3D24C22934A69BB66D0 -at- phx -dot- gbl>
Content-Type: text/plain; charset="iso-8859-1"

I was wondering if anyone knew of the legal requirements for font size
and publication accessibility and where to obtain copies- specifically
pertaining to font size. We have design standards, but no copies of the
actual laws. I know there is something out there, I just can't find it,
and searching the ADA website turned up a lot of design standards for
buildings but not anything on documents. Thanks!

Kate
_________________________________________________________________
Your friends are close to you.?Keep them that way.
http://spaces.live.com/signup.aspx

------------------------------

Message: 6
Date: Wed, 28 Mar 2007 09:06:03 -0400
From: "Dori Green" <dgreen -at- associatedbrands -dot- com>
Subject: RE: Getting Black Balled by a Doc Manager & Filing for
Unemployment-Need Advice
To: <techwr-l -at- lists -dot- techwr-l -dot- com>
Message-ID: <HFEFKEECOFNMGKOMDFLPKEPACIAA -dot- dgreen -at- associatedbrands -dot- com>
Content-Type: text/plain; charset="us-ascii"

Anthony,

Most of us who have been in this profession for a while have experienced
this or something similar. I have had projects terminated when called
in to
the agency's office to talk about my overdue cost of living raise (and
while
you're here, please turn in your card key, you're not going back), and
by
e-mail when they finally agreed to let me work at home on the day after
a
major blizzard (and by the way, please drive across New Jersey to bring
back
all company materials on your own time as soon as the roads are clear).

Do not assume that it will reflect badly on you. Remember that the best
revenge is better pay closer to home.

Loss of a job is a major blow. If you have access to an Employee
Assistance
Program, use it.

Do sit down and carefully document your side of the situation while it's
fresh in your memory. Then file that record in your own filing cabinet.
Only pull it out if they try to challenge your unemployment claim. It's
a
little suspicious that they asked you to resign, which is usually done
just
so they can try to wiggle out of paying unemployment. If you can, get a
written statement from your witness just in case.

Sometimes these things happen just because Somebody Up There wants to
make
use of us someplace else and there is no more rational reason for it
than
that. Betrayal can be a spiritual crisis; if you are active in a
community
of faith call on them for support.

You aren't the first, won't be the last. Darn it.

Look around for that better pay closer to home.

Dori Green



------------------------------

Message: 7
Date: Wed, 28 Mar 2007 09:21:35 -0400
From: <richard -dot- melanson -at- us -dot- tel -dot- com>
Subject: Questions About Arbortext.
To: <techwr-l -at- lists -dot- techwr-l -dot- com>
Message-ID:
<DBB2E440DE7DB54C80998A2D274B9EDC01977C -at- temis0520 -dot- us -dot- tel -dot- com>
Content-Type: text/plain; charset="us-ascii"

Hello TechWR-L,
I am on my second day at a new employer and they use Arbortext Editor
(Epic) and SiberSafe Client for all of their documentation creation. I
am pretty much a Framemaker writer, also having used Word and PageMaker
on some projects. Can I get anyones/everyones opinions on these
products, what are your experiences like, should I try and convince them
to go to Framemaker, should I run away screaming :-) Any input you can
give me on these products is greatly appreciated. Thank you.

Arbortext Editor (Epic)
SiberSafe Client

Richard Melanson
Technical Writer
Epion Corporation
37 Manning Road
Billerica, MA, 01821
USA Tel: 978-670-1910, Ext 204
Fax: 978-670-9119



------------------------------

Message: 8
Date: Wed, 28 Mar 2007 09:30:12 -0400
From: "Dori Green" <dgreen -at- associatedbrands -dot- com>
Subject: RE: Boss key
To: <techwr-l -at- lists -dot- techwr-l -dot- com>
Message-ID: <HFEFKEECOFNMGKOMDFLPEEPBCIAA -dot- dgreen -at- associatedbrands -dot- com>
Content-Type: text/plain; charset="us-ascii"

It's so much easier just to tell the truth and not goof off.

If I plan to do anything that might be perceived as goofing off (e.g.,
participate in e-mail lists), I discuss the idea with my boss as a
colleague
first. If we agree that the occasional gems I glean are worth the bit
of
time spent, he usually grants permission. If I cannot show a worthwhile
gem
collection, my conscience leads me to unsubscribe even if a list is lots
of
fun. My boss knows that he can trust me to exercise good judgement and
good
conscience.

And I assume that somebody is watching and reading. Always.

Dori Green



------------------------------

Message: 9
Date: Wed, 28 Mar 2007 09:34:15 -0400
From: "Dori Green" <dgreen -at- associatedbrands -dot- com>
Subject: RE: What is an engineering department and what does it do?
To: <techwr-l -at- lists -dot- techwr-l -dot- com>
Message-ID: <HFEFKEECOFNMGKOMDFLPKEPBCIAA -dot- dgreen -at- associatedbrands -dot- com>
Content-Type: text/plain; charset="us-ascii"

Those are the guys who keep pleading with the Marketing Dept. as
follows:

"No, the product does not do that. PLEASE stop telling the customers it
will."

Dori Green



------------------------------

Message: 10
Date: Wed, 28 Mar 2007 05:57:53 -0600
From: TECHWR-L Administrator <admin -at- techwr-l -dot- com>
Subject: ADMIN: Please, let's keep it on track
To: TECHWR-L <techwr-l -at- lists -dot- techwr-l -dot- com>
Message-ID: <460A5841 -dot- 5040604 -at- techwr-l -dot- com>
Content-Type: text/plain; charset=ISO-8859-1; format=flowed


All,
Please, let's keep focused on technical communication, and
take other discussions (boss key, sugar in the gas, etc.)
elsewhere. techwr-l-chat -at- lists -dot- techwr-l -dot- com is one of many
options.
Thanks,
TECHWR-L Admins




------------------------------

Message: 11
Date: Wed, 28 Mar 2007 09:52:36 -0400
From: Geoff Hart <ghart -at- videotron -dot- ca>
Subject: Legal requirements for document accessibility?
To: TECHWR-L <techwr-l -at- lists -dot- techwr-l -dot- com>, Kate Salm
<catrose15 -at- hotmail -dot- com>
Message-ID: <EE583DD0-5C0C-4B09-8403-FCDA9AD83B76 -at- videotron -dot- ca>
Content-Type: text/plain; charset=US-ASCII; delsp=yes; format=flowed

Kate Salm wondered: <<I was wondering if anyone knew of the legal
requirements for font size and publication accessibility and where to
obtain copies- specifically pertaining to font size. We have design
standards, but no copies of the actual laws. I know there is
something out there, I just can't find it, and searching the ADA
website turned up a lot of design standards for buildings but not
anything on documents.>>

Possibly do some searching here: http://www.section508.gov/


----------------------------------------------------
-- Geoff Hart
ghart -at- videotron -dot- ca / geoffhart -at- mac -dot- com
www.geoff-hart.com
--------------------------------------------------
Coming soon: _Effective onscreen editing_ (http://www.geoff-hart.com/
home/onscreen-book.htm)



------------------------------

Message: 12
Date: Wed, 28 Mar 2007 06:51:40 -0700
From: "Mark Barrera - Tech Writer" <mdb-career -at- cox -dot- net>
Subject: RE: Getting Black Balled by a Doc Manager & Filing
forUnemployment-Need Advice
To: <techwr-l -at- lists -dot- techwr-l -dot- com>
Message-ID:

<!&!AAAAAAAAAAAYAAAAAAAAADL8dQ9koHZAsi00URQPv1liwAAAEAAAAOAuz5P0SyNOglEj
6OIgjKsBAAAAAA== -at- cox -dot- net>

Content-Type: text/plain; charset="us-ascii"


I think this is another case where some advice I received
on my first job would be an enormous help.

Keep a daily journal.

If a problem starts to arise - keep a separate folder for
files that chronologically document the problem.

Makes it much easier to take action if necessary.

Mdb
mdbinc.com




------------------------------

Message: 13
Date: Wed, 28 Mar 2007 14:10:47 +0000
From: Kate Salm <catrose15 -at- hotmail -dot- com>
Subject: RE: Legal requirements for document accessibility?
To: Geoff Hart <ghart -at- videotron -dot- ca>, <techwr-l -at- lists -dot- techwr-l -dot- com>
Message-ID: <BAY128-W21299E8797128B0178A2FBB66D0 -at- phx -dot- gbl>
Content-Type: text/plain; charset="iso-8859-1"

Sorry, I should have been more specific. I have the 508 standards. I
need to know what else there is, if anything. Sorry! Thanks!Kate

> Date: Wed, 28 Mar 2007 09:52:36 -0400> From: ghart -at- videotron -dot- ca>
Subject: Legal requirements for document accessibility?> To:
techwr-l -at- lists -dot- techwr-l -dot- com; catrose15 -at- hotmail -dot- com> > Kate Salm
wondered: <<I was wondering if anyone knew of the legal > requirements
for font size and publication accessibility and where to > obtain
copies- specifically pertaining to font size. We have design >
standards, but no copies of the actual laws. I know there is > something
out there, I just can't find it, and searching the ADA > website turned
up a lot of design standards for buildings but not > anything on
documents.>>> > Possibly do some searching here:
http://www.section508.gov/> > >
----------------------------------------------------> -- Geoff Hart>
ghart -at- videotron -dot- ca / geoffhart -at- mac -dot- com> www.geoff-hart.com>
--------------------------------------------------> Coming soon:
_Effective onscreen editing_ (http://www.geoff-hart.com/ >
home/onscreen-book.htm)>
_________________________________________________________________
Take a break and play crossword puzzles - FREE!
http://games.msn.com/en/flexicon/default.htm?icid=flexicon_
wlmemailtaglinemarch07

------------------------------

Message: 14
Date: Wed, 28 Mar 2007 10:14:13 -0400
From: "Char James-Tanny" <charjtf -at- gmail -dot- com>
Subject: Re: Legal requirements for document accessibility.
To: techwr-l -at- lists -dot- techwr-l -dot- com
Message-ID:
<c0ef8fb70703280714x20380ca5w5af2dbf65ca832c0 -at- mail -dot- gmail -dot- com>
Content-Type: text/plain; charset=ISO-8859-1; format=flowed

Hi, Kate :-)

> I was wondering if anyone knew of the legal requirements for font size
and publication accessibility and where to obtain copies- specifically
pertaining to font size. We have design standards, but no copies of the
actual laws. I know there is something out there, I just can't find it,
and searching the ADA website turned up a lot of design standards for
buildings but not anything on documents. Thanks!

Is this for print or for online?

Char James-Tanny ~ JTF Associates, Inc. ~ http://www.helpstuff.com
----------------------------------------------------------
Please send follow-up questions to the list. (Inquires sent off-list
may not be seen.)
Contact me directly (CharJT at helpstuff dot com) with business
inquiries.
----------------------------------------------------------
2006-2007 Microsoft Help MVP
Find a Help Authoring Tool at HAT-Matrix.com ~ http://hat-matrix.com
Co-author of "Managing Virtual Teams" ~ http://www.wordware.com/wiki
AuthorIT Certified Consultant, Development, and Training
STC Secretary, 2006-2008
Web site Hosting and Design ~ http://www.jtfhosting.com


------------------------------

Message: 15
Date: Wed, 28 Mar 2007 07:19:16 -0700 (PDT)
From: John Posada <jposada01 -at- yahoo -dot- com>
Subject: RE: Boss key
To: techwr-l -at- lists -dot- techwr-l -dot- com
Message-ID: <857240 -dot- 40085 -dot- qm -at- web35415 -dot- mail -dot- mud -dot- yahoo -dot- com>
Content-Type: text/plain; charset=iso-8859-1

> If I plan to do anything that might be perceived as
> goofing off (e.g., participate in e-mail lists), I discuss
> the idea with my boss as a colleague first. If we agree that
> the occasional gems I glean are worth the

I've had three gigs where this subject came up.

Where I am now, my manager not only knows that I participate in these
lists, but will, time to time, ask me to post a question. In fact,
the company has a web page with guidelines on how to participate
(what to say and not say) in lists, blogs, etc.

A previous gig, my instruction was to not include the company name in
the post, such as a sig, because they wanted to make sure that if
someone did a search on the company name, my posts wouldn't be
included in the results.

And, BTW, when I was being considered for this position, they did a
search on my name and it was because of my posts (what I say and how
I say it) on this and framers that added to their opinion to
interview me.

John Posada
Senior Technical Writer

"They say everyone needs goals. Mine is to live forever.
So far, so good."


------------------------------

Message: 16
Date: Wed, 28 Mar 2007 14:23:36 +0000
From: Kate Salm <catrose15 -at- hotmail -dot- com>
Subject: RE: Legal requirements for document accessibility.
To: Char James-Tanny <charjtf -at- gmail -dot- com>,
<techwr-l -at- lists -dot- techwr-l -dot- com>
Message-ID: <BAY128-W7BB61A12F5C0ABA7CF07FB66D0 -at- phx -dot- gbl>
Content-Type: text/plain; charset="iso-8859-1"

Print mainly, some of the print publications will be put on-line.Kate

> Date: Wed, 28 Mar 2007 10:14:13 -0400> From: charjtf -at- gmail -dot- com> To:
techwr-l -at- lists -dot- techwr-l -dot- com> Subject: Re: Legal requirements for
document accessibility.> > Hi, Kate :-)> > > I was wondering if anyone
knew of the legal requirements for font size and publication
accessibility and where to obtain copies- specifically pertaining to
font size. We have design standards, but no copies of the actual laws. I
know there is something out there, I just can't find it, and searching
the ADA website turned up a lot of design standards for buildings but
not anything on documents. Thanks!> > Is this for print or for online?>
> Char James-Tanny ~ JTF Associates, Inc. ~ http://www.helpstuff.com>
----------------------------------------------------------> Please send
follow-up questions to the list. (Inquires sent off-list> may not be
seen.)> Contact me directly (CharJT at helpstuff dot com) with business
inquiries.> ---------------------------------------------------------->
2006-2007 Mic
rosoft Help MVP> Find a Help Authoring Tool at HAT-Matrix.com ~
http://hat-matrix.com> Co-author of "Managing Virtual Teams" ~
http://www.wordware.com/wiki> AuthorIT Certified Consultant,
Development, and Training> STC Secretary, 2006-2008> Web site Hosting
and Design ~ http://www.jtfhosting.com>
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^> > 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 &amp; 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
&amp; Manual: http://www.helpandmanual.com> > ---> You are currently
subscribed to TECHWR-L as catrose15 -at- hotmail -dot- com -dot- > > To unsubscribe send
a blank email to > techwr-l-unsubscribe -at- lists -dot- techwr-l -dot- com> or visit
http://lists.t
echwr-l.com/mailman/options/techwr-l/catrose15%40hotmail.com> > > To
subscribe, send a blank email to techwr-l-join -at- lists -dot- techwr-l -dot- com> >
Send administrative questions to admin -at- techwr-l -dot- com -dot- Visit>
http://www.techwr-l.com/techwhirl/ for more resources and info.>
_________________________________________________________________
Take a break and play crossword puzzles - FREE!
http://games.msn.com/en/flexicon/default.htm?icid=flexicon_
wlmemailtaglinemarch07

------------------------------

Message: 17
Date: Wed, 28 Mar 2007 10:24:53 -0400
From: Melissa Nelson <melmis36 -at- hotmail -dot- com>
Subject: RE: Boss key
To: <techwr-l -at- lists -dot- techwr-l -dot- com>
Message-ID: <BAY105-W19F520ED041BB15177A716D96D0 -at- phx -dot- gbl>
Content-Type: text/plain; charset="iso-8859-1"

My boss also knows that I participate in tech writer lists. He has also
asked me to post questions for him. It is not uncommon for him to say
"Do you or anyone on your techwriter list know how to....?" Not to
mention, when I had my yearly review my joining tech writer lists was
mentioned in my "showing initiative and ability to learn new things"
section. :) I was very happy with my review and this list was one of the
reasons. :)

Melissa



> Date: Wed, 28 Mar 2007 07:19:16 -0700> From: jposada01 -at- yahoo -dot- com>
Subject: RE: Boss key> To: techwr-l -at- lists -dot- techwr-l -dot- com> > > If I plan to
do anything that might be perceived as > > goofing off (e.g.,
participate in e-mail lists), I discuss > > the idea with my boss as a
colleague first. If we agree that > > the occasional gems I glean are
worth the> > I've had three gigs where this subject came up.> > Where I
am now, my manager not only knows that I participate in these> lists,
but will, time to time, ask me to post a question. In fact,> the company
has a web page with guidelines on how to participate> (what to say and
not say) in lists, blogs, etc.> > A previous gig, my instruction was to
not include the company name in> the post, such as a sig, because they
wanted to make sure that if> someone did a search on the company name,
my posts wouldn't be> included in the results.> > And, BTW, when I was
being considered for this position, they did a> search on my name and it
wa
s because of my posts (what I say and how> I say it) on this and
framers that added to their opinion to> interview me.> > John Posada>
Senior Technical Writer> > "They say everyone needs goals. Mine is to
live forever.> So far, so good.">
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^> > 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 &amp; 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
&amp; Manual: http://www.helpandmanual.com> > ---> You are currently
subscribed to TECHWR-L as melmis36 -at- hotmail -dot- com -dot- > > To unsubscribe send a
blank email to > techwr-l-unsubscribe -at- lists -dot- techwr-l -dot- com> or visit
http://lists.techwr-l.com/mailman/options/techwr-l/melmis36%40hotmail.co
m>
> > To subscribe, send a blank email to
techwr-l-join -at- lists -dot- techwr-l -dot- com> > Send administrative questions to
admin -at- techwr-l -dot- com -dot- Visit> http://www.techwr-l.com/techwhirl/ for more
resources and info.>

------------------------------

Message: 18
Date: Wed, 28 Mar 2007 20:01:10 +0530
From: "Hemanth Basrur" <hemanth -dot- basrur -at- gmail -dot- com>
Subject: Re: Legal requirements for document accessibility?
To: "Kate Salm" <catrose15 -at- hotmail -dot- com>
Cc: techwr-l -at- lists -dot- techwr-l -dot- com
Message-ID:
<63d4ac090703280731g5af97c8eyfbfa70fd0ba4e79a -at- mail -dot- gmail -dot- com>
Content-Type: text/plain; charset=ISO-8859-1; format=flowed

Hi Kate,

Refer the following links:

http://www.uiaccess.com/access_links.html
http://www-03.ibm.com/able/laws/index.html

Regards,
Hemanth


On 3/28/07, Kate Salm <catrose15 -at- hotmail -dot- com> wrote:
>
> Sorry, I should have been more specific. I have the 508 standards. I
> need to know what else there is, if anything. Sorry! Thanks!Kate
>
> > Date: Wed, 28 Mar 2007 09:52:36 -0400> From: ghart -at- videotron -dot- ca>
> Subject: Legal requirements for document accessibility?> To:
> techwr-l -at- lists -dot- techwr-l -dot- com; catrose15 -at- hotmail -dot- com> > Kate Salm
wondered:
> <<I was wondering if anyone knew of the legal > requirements for font
size
> and publication accessibility and where to > obtain copies-
specifically
> pertaining to font size. We have design > standards, but no copies of
the
> actual laws. I know there is > something out there, I just can't find
it,
> and searching the ADA > website turned up a lot of design standards
for
> buildings but not > anything on documents.>>> > Possibly do some
searching
> here: http://www.section508.gov/> > >
> ----------------------------------------------------> -- Geoff Hart>
> ghart -at- videotron -dot- ca / geoffhart -at- mac -dot- com> www.geoff-hart.com>
> --------------------------------------------------> Coming soon:
_Effective
> onscreen editing_ (http://www.geoff-hart.com/ >
home/onscreen-book.htm)>
> _________________________________________________________________
> Take a break and play crossword puzzles - FREE!
>
http://games.msn.com/en/flexicon/default.htm?icid=flexicon_wlmemailtagli
nemarch07
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> 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 hemanth -dot- basrur -at- gmail -dot- com -dot-
>
> To unsubscribe send a blank email to
> techwr-l-unsubscribe -at- lists -dot- techwr-l -dot- com
> or visit
>
http://lists.techwr-l.com/mailman/options/techwr-l/hemanth.basrur%40gmai
l.com
>
>
> To subscribe, send a blank email to techwr-l-join -at- lists -dot- techwr-l -dot- com
>
> Send administrative questions to admin -at- techwr-l -dot- com -dot- Visit
> http://www.techwr-l.com/techwhirl/ for more resources and info.
>
>


------------------------------

Message: 19
Date: Wed, 28 Mar 2007 10:01:25 -0600
From: "technical writing plus" <doc-x -at- earthlink -dot- net>
Subject: what is authentic assessment about and how is it used in
technical communication
To: <techwr-l -at- lists -dot- techwr-l -dot- com>
Message-ID: <001d01c77152$5787c100$2101a8c0 -at- ThomJames>
Content-Type: text/plain; charset="US-ASCII"

Authentic Assessment - what is it and how is it used. Does someone on
this
list have experience with it? Thanks.

Jim Jones http://tinyurl.com/4arjc



------------------------------

Message: 20
Date: Wed, 28 Mar 2007 15:21:03 +0000
From: stevefjong -at- comcast -dot- net
Subject: Re: Legal requirements for document accessibility?
To: TECHWR-L <techwr-l -at- lists -dot- techwr-l -dot- com>, Kate Salm
<catrose15 -at- hotmail -dot- com>
Message-ID:

<032820071521.11246.460A87DF0000E7C900002BEE220642441309020106000A900A9B
9C -at- comcast -dot- net>

Content-Type: text/plain

I seem to remember a requirement that US contracts must br printed in
type of at least 6 points; I can't cite a source, but it makes sense.
(Horror story: when the Honeywell doc group I worked in was laid off en
masse and converted to contractors, I signed my contract only after
reading it thoroughly and looking at the back to verify it was blank.
Some time later, a colleague mentioned an onerous condition in the
contract that I didn't recall, and said it was on the back. I looked
again, and this time saw that the back was *crammed* with gray, 4-point
type, which I'd completely missed when I looked the first time!)

-- Steve

Steven Jong ("Typo? What tpyo?")
Past President, STC Boston Chapter
stevefjong -at- comcast -dot- net, 978-413-2553 [C]
* I am a candidate for STC Director | For more info, visit:
www.StevenJong.net *

------------------------------

Message: 21
Date: Wed, 28 Mar 2007 09:22:00 -0600
From: "Combs, Richard" <richard -dot- combs -at- Polycom -dot- com>
Subject: RE: what is authentic assessment about and how is it used in
technicalcommunication
To: "technical writing plus" <doc-x -at- earthlink -dot- net>,
<techwr-l -at- lists -dot- techwr-l -dot- com>
Message-ID:

<AABEB232F95338499DF8F513EE2B2C784C2EC0 -at- WSTEXCH00 -dot- westminster -dot- polycom -dot- co
m>

Content-Type: text/plain; charset="us-ascii"

technical writing plus wrote:

> Authentic Assessment - what is it and how is it used. Does
> someone on this list have experience with it? Thanks.

It's an educational thing. A Google search on that phrase turns up
mostly .edu addresses. The first Google hit answers the question, "What
is Authentic Assessment?" Here's one of several definitions provided:

"A form of assessment in which students are asked to perform real-world
tasks that demonstrate meaningful application of essential knowledge and
skills -- Jon Mueller"

AA is contrasted with Traditional Assessment (TA) -- multiple-choice
tests, etc. In TA, the curriculum drives assessment -- you first decide
what body of knowledge to convey, and then develop questions testing
that knowledge. In AA, the assessment drives the curriculum -- you first
determine what tasks students must perform to demonstrate competence,
and then you develop a curriculum that teaches them those tasks.

I have no idea what this has to do with tech comm. Maybe some of the
other Google hits can help. I searched for "authentic assessment" with
the quotes.

Richard


------
Richard G. Combs
Senior Technical Writer
Polycom, Inc.
richardDOTcombs AT polycomDOTcom
303-223-5111
------
rgcombs AT gmailDOTcom
303-777-0436
------






------------------------------

Message: 22
Date: Wed, 28 Mar 2007 10:31:55 -0500
From: "David Neeley" <dbneeley -at- gmail -dot- com>
Subject: Re: Unimployment in Texas
To: techwr-l -at- lists -dot- techwr-l -dot- com
Message-ID:
<e86e45c10703280831t54103fb7h1f7697a7f6cc194c -at- mail -dot- gmail -dot- com>
Content-Type: text/plain; charset=ISO-8859-1; format=flowed

Another esteemed member said about claiming unemployment compensation in
Texas:

"You and your horse(s) have to make an appearance at the downtown
office."

That is incorrect.

In Texas, the claim for unemployment compensation can be made in one of
two
ways:

*Online, through http://www.twc.state.tx.us/ (note the "apply for
benefits"
link)

*By telephone

I have just gone through that process--seeking to apply at one of their
walk-in offices. I was told in no uncertain terms that I had to do one
of
the above, and that this is the *only* process that can be followed.

You will give them the information regarding your situation, and they
will
do any confirmation that they need--including contacting your prior
employer.

If they need additional information thereafter, they will let you know.

Once you are on unemployment, you must keep a log of the contacts you
make
in seeking new work; after eight weeks of benefits, you must be willing
to
reduce your rate of compensation by a minimum percentage or lose
benefits.

It is quite true that Texas is an at-will state as well as a right to
work
state (no compulsory unions). In fact, some companies do not permit the
time-honored two week notice--if you attempt to give one, you are
immediately out the door.

David


------------------------------

Message: 23
Date: Wed, 28 Mar 2007 11:33:16 -0400 (EDT)
From: Milan Davidovic <shl_ctf -at- yahoo -dot- ca>
Subject: Re: what is authentic assessment about and how is it used in
technical communication
To: technical writing plus <doc-x -at- earthlink -dot- net>,
techwr-l -at- lists -dot- techwr-l -dot- com
Message-ID: <403095 -dot- 55473 -dot- qm -at- web56407 -dot- mail -dot- re3 -dot- yahoo -dot- com>
Content-Type: text/plain; charset=iso-8859-1

--- technical writing plus <doc-x -at- earthlink -dot- net>
wrote:
> Authentic Assessment - what is it and how is it
> used. Does someone on this
> list have experience with it?

>From this, itooks like a school thing:

http://en.wikipedia.org/wiki/Authentic_assessment


Milan
http://altmilan.blogspot.com
http://www.terminus1525.ca/studio/view/2758

__________________________________________________
Do You Yahoo!?
Tired of spam? Yahoo! Mail has the best spam protection around
http://mail.yahoo.com


------------------------------

Message: 24
Date: Wed, 28 Mar 2007 11:33:29 -0400 (EDT)
From: Milan Davidovic <shl_ctf -at- yahoo -dot- ca>
Subject: Re: what is authentic assessment about and how is it used in
technical communication
To: technical writing plus <doc-x -at- earthlink -dot- net>,
techwr-l -at- lists -dot- techwr-l -dot- com
Message-ID: <282809 -dot- 19042 -dot- qm -at- web56405 -dot- mail -dot- re3 -dot- yahoo -dot- com>
Content-Type: text/plain; charset=iso-8859-1

--- technical writing plus <doc-x -at- earthlink -dot- net>
wrote:
> Authentic Assessment - what is it and how is it
> used. Does someone on this
> list have experience with it?

>From this, itooks like a school thing:

http://en.wikipedia.org/wiki/Authentic_assessment


Milan
http://altmilan.blogspot.com
http://www.terminus1525.ca/studio/view/2758

__________________________________________________
Do You Yahoo!?
Tired of spam? Yahoo! Mail has the best spam protection around
http://mail.yahoo.com


------------------------------

Message: 25
Date: Wed, 28 Mar 2007 11:33:40 -0400 (EDT)
From: Milan Davidovic <shl_ctf -at- yahoo -dot- ca>
Subject: Re: what is authentic assessment about and how is it used in
technical communication
To: technical writing plus <doc-x -at- earthlink -dot- net>,
techwr-l -at- lists -dot- techwr-l -dot- com
Message-ID: <640881 -dot- 21200 -dot- qm -at- web56413 -dot- mail -dot- re3 -dot- yahoo -dot- com>
Content-Type: text/plain; charset=iso-8859-1

--- technical writing plus <doc-x -at- earthlink -dot- net>
wrote:
> Authentic Assessment - what is it and how is it
> used. Does someone on this
> list have experience with it?

>From this, itooks like a school thing:

http://en.wikipedia.org/wiki/Authentic_assessment


Milan
http://altmilan.blogspot.com
http://www.terminus1525.ca/studio/view/2758

__________________________________________________
Do You Yahoo!?
Tired of spam? Yahoo! Mail has the best spam protection around
http://mail.yahoo.com


------------------------------

Message: 26
Date: Wed, 28 Mar 2007 11:36:09 -0400 (EDT)
From: Milan Davidovic <shl_ctf -at- yahoo -dot- ca>
Subject: duplicate posts from me?
To: TECHWR-L <techwr-l -at- lists -dot- techwr-l -dot- com>
Message-ID: <955819 -dot- 17956 -dot- qm -at- web56401 -dot- mail -dot- re3 -dot- yahoo -dot- com>
Content-Type: text/plain; charset=iso-8859-1

Something weird just happened on Yahoo!. I just
checked my Sent box and it shows duplicate posts from
me to this list and to the person I was responding to.

(I hope this one doesn't duplicate itself; let's
see... )

Milan
http://altmilan.blogspot.com
http://www.terminus1525.ca/studio/view/2758

__________________________________________________
Do You Yahoo!?
Tired of spam? Yahoo! Mail has the best spam protection around
http://mail.yahoo.com


------------------------------

Message: 27
Date: Wed, 28 Mar 2007 13:34:47 -0400
From: "Dan Goldstein" <DGoldstein -at- riverainmedical -dot- com>
Subject: The cost of inaccurate technical documentation
To: <techwr-l -at- lists -dot- techwr-l -dot- com>
Message-ID:
<0ADA9A22B5BC2147B360A22FD2BAD25CA91731 -at- RMGBEX01 -dot- rmg -dot- local>
Content-Type: text/plain; charset="us-ascii"

This subject comes up occasionally on the list, and we've all seen the
classic examples. Here's another:

Telecommunications entrepreneur Walter Anderson should have been ordered
to repay the federal government $100 million to $175 million. The judge
couldn't issue the order because:

A) The plea agreement with Anderson listed the wrong statute.
B) "Prosecutors omitted any discussion of probation -- a common element
of plea deals -- from Anderson's paperwork." (Source: AP)

So that's just two errors, at an estimated cost of $50 to $87.5 million
per error.























This message contains confidential information intended only for the use
of the addressee(s). If you are not the addressee, or the person
responsible for delivering it to the addressee, you are hereby notified
that reading, disseminating, distributing, copying, electronic storing
or the taking of any action in reliance on the contents of this message
is strictly prohibited. If you have received this message by mistake,
please notify us, by replying to the sender, and delete the original
message immediately thereafter. Thank you.



------------------------------

Message: 28
Date: Wed, 28 Mar 2007 12:36:27 -0500
From: "Keith Hansen" <KRH -at- weiland-wfg -dot- com>
Subject: RoboHelp: WinHelp: TOC not Updating
To: <techwr-l -at- lists -dot- techwr-l -dot- com>
Message-ID:

<B4DBD1887147DE4BBAB1CBD0C1C99AD9AE90B7 -at- wfg-win2k3-exch -dot- WFG -dot- LOCAL>
Content-Type: text/plain; charset="us-ascii"


Hello all,

I'm working in RoboHelp creating a WinHelp project. In RoboHelp Explorer
(the TOC pane), I added some topics under a TOC book and then later
deleted them.

However, when I compile (generate) the WinHelp project, those deleted
topics still show up in the TOC under the book.

Any idea why? Any idea how to resolve this?

Thanks!

Keith


------------------------------

Message: 29
Date: Wed, 28 Mar 2007 13:44:32 -0400
From: "Pro TechWriter" <pro -dot- techwriter -at- gmail -dot- com>
Subject: Re: RoboHelp: WinHelp: TOC not Updating
To: "Keith Hansen" <KRH -at- weiland-wfg -dot- com>
Cc: techwr-l -at- lists -dot- techwr-l -dot- com
Message-ID:
<6b35bddb0703281044r69be4e98jfba0aaa152f76aa2 -at- mail -dot- gmail -dot- com>
Content-Type: text/plain; charset=ISO-8859-1; format=flowed

Are the topics listed in the baggage folder (under the Project tab)? If
so,
delete them from there, save, and recompile.

Let me know if that works.

PT


On 3/28/07, Keith Hansen <KRH -at- weiland-wfg -dot- com> wrote:
>
>
> Hello all,
>
> I'm working in RoboHelp creating a WinHelp project. In RoboHelp
Explorer
> (the TOC pane), I added some topics under a TOC book and then later
> deleted them.
>
> However, when I compile (generate) the WinHelp project, those deleted
> topics still show up in the TOC under the book.
>
> Any idea why? Any idea how to resolve this?
>
> Thanks!
>
> Keith
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> 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 &amp; 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 &amp; Manual: http://www.helpandmanual.com
>
> ---
> You are currently subscribed to TECHWR-L as pro -dot- techwriter -at- gmail -dot- com -dot-
>
> To unsubscribe send a blank email to
> techwr-l-unsubscribe -at- lists -dot- techwr-l -dot- com
> or visit
>
http://lists.techwr-l.com/mailman/options/techwr-l/pro.techwriter%40gmai
l.com
>
>
> To subscribe, send a blank email to techwr-l-join -at- lists -dot- techwr-l -dot- com
>
> Send administrative questions to admin -at- techwr-l -dot- com -dot- Visit
> http://www.techwr-l.com/techwhirl/ for more resources and info.
>
>


--
PT
pro -dot- techwriter -at- gmail -dot- com
I'm a Technical Technical Writer!


------------------------------

Message: 30
Date: Wed, 28 Mar 2007 11:08:14 -0700 (PDT)
From: John Posada <jposada01 -at- yahoo -dot- com>
Subject: Re: The cost of inaccurate technical documentation
To: Dan Goldstein <DGoldstein -at- riverainmedical -dot- com>,
techwr-l -at- lists -dot- techwr-l -dot- com
Message-ID: <30398 -dot- 20433 -dot- qm -at- web35411 -dot- mail -dot- mud -dot- yahoo -dot- com>
Content-Type: text/plain; charset=iso-8859-1

> So that's just two errors, at an estimated cost of $50 to $87.5
> million per error.

That's not technical documentation...it's legal documentation.
Lawyers don't employ technical writers to write that type of
documentation...they use paralegals and law clerks.

It's not the same thing. In fct, I'd say they couldn't be farther
apart. Tech documents take difficult concepts and describe them
simply. Legal documents intentionaly allow for interpretation.

John Posada
Senior Technical Writer

"They say everyone needs goals. Mine is to live forever.
So far, so good."


------------------------------

Message: 31
Date: Wed, 28 Mar 2007 14:22:32 -0400
From: "Dan Goldstein" <DGoldstein -at- riverainmedical -dot- com>
Subject: RE: The cost of inaccurate technical documentation
To: <techwr-l -at- lists -dot- techwr-l -dot- com>
Message-ID:
<0ADA9A22B5BC2147B360A22FD2BAD25CA9174D -at- RMGBEX01 -dot- rmg -dot- local>
Content-Type: text/plain; charset="us-ascii"

The crucial missing information was the numerical citation of a statute.
Sounds pretty technical to me. And if the document had been written as
required, it would not have "allowed for interpretation."

Depending on its content, legal documentation can be a subset of
technical documentation -- just like chemical documentation, medical
documentation, traffic control documentation...

> -----Original Message-----
> From: John Posada
> Sent: Wednesday, March 28, 2007 2:08 PM
> To: Dan Goldstein; techwr-l -at- lists -dot- techwr-l -dot- com
> Subject: Re: The cost of inaccurate technical documentation
>
> > So that's just two errors, at an estimated cost of $50 to $87.5
> > million per error.
>
> That's not technical documentation...it's legal documentation.
> Lawyers don't employ technical writers to write that type of
> documentation...they use paralegals and law clerks.
>
> It's not the same thing. In fact, I'd say they couldn't be farther
> apart. Tech documents take difficult concepts and describe them
> simply. Legal documents intentionally allow for interpretation.
>

This message contains confidential information intended only for the use
of the addressee(s). If you are not the addressee, or the person
responsible for delivering it to the addressee, you are hereby notified
that reading, disseminating, distributing, copying, electronic storing
or the taking of any action in reliance on the contents of this message
is strictly prohibited. If you have received this message by mistake,
please notify us, by replying to the sender, and delete the original
message immediately thereafter. Thank you.



------------------------------

Message: 32
Date: Wed, 28 Mar 2007 11:30:15 -0700 (PDT)
From: John Posada <jposada01 -at- yahoo -dot- com>
Subject: RE: The cost of inaccurate technical documentation
To: Dan Goldstein <DGoldstein -at- riverainmedical -dot- com>,
techwr-l -at- lists -dot- techwr-l -dot- com
Message-ID: <497032 -dot- 53369 -dot- qm -at- web35403 -dot- mail -dot- mud -dot- yahoo -dot- com>
Content-Type: text/plain; charset=iso-8859-1

> The crucial missing information was the numerical citation of a
> statute.
> Sounds pretty technical to me. And if the document had been written

What?

That's like saying that because Stephen King puts numbers on his
chapter, they're technical documents.

It's not technical...just sloppy.




> as
> required, it would not have "allowed for interpretation."
>
> Depending on its content, legal documentation can be a subset of
> technical documentation -- just like chemical documentation,
> medical
> documentation, traffic control documentation...
>
> > -----Original Message-----
> > From: John Posada
> > Sent: Wednesday, March 28, 2007 2:08 PM
> > To: Dan Goldstein; techwr-l -at- lists -dot- techwr-l -dot- com
> > Subject: Re: The cost of inaccurate technical documentation
> >
> > > So that's just two errors, at an estimated cost of $50 to $87.5
> > > million per error.
> >
> > That's not technical documentation...it's legal documentation.
> > Lawyers don't employ technical writers to write that type of
> > documentation...they use paralegals and law clerks.
> >
> > It's not the same thing. In fact, I'd say they couldn't be
> farther
> > apart. Tech documents take difficult concepts and describe them
> > simply. Legal documents intentionally allow for interpretation.
> >
>
> This message contains confidential information intended only for
> the use of the addressee(s). If you are not the addressee, or the
> person responsible for delivering it to the addressee, you are
> hereby notified that reading, disseminating, distributing, copying,
> electronic storing or the taking of any action in reliance on the
> contents of this message is strictly prohibited. If you have
> received this message by mistake, please notify us, by replying to
> the sender, and delete the original message immediately thereafter.
> Thank you.
>
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> 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 &amp; 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 &amp; Manual:
> http://www.helpandmanual.com
>
> ---
> You are currently subscribed to TECHWR-L as jposada01 -at- yahoo -dot- com -dot-
>
> To unsubscribe send a blank email to
> techwr-l-unsubscribe -at- lists -dot- techwr-l -dot- com
> or visit
>
http://lists.techwr-l.com/mailman/options/techwr-l/jposada01%40yahoo.com
>
>
> To subscribe, send a blank email to
> techwr-l-join -at- lists -dot- techwr-l -dot- com
>
> Send administrative questions to admin -at- techwr-l -dot- com -dot- Visit
> http://www.techwr-l.com/techwhirl/ for more resources and info.
>
>


John Posada
Senior Technical Writer

"They say everyone needs goals. Mine is to live forever.
So far, so good."


------------------------------

Message: 33
Date: Wed, 28 Mar 2007 14:41:53 -0400
From: "Dan Goldstein" <DGoldstein -at- riverainmedical -dot- com>
Subject: RE: The cost of inaccurate technical documentation
To: <techwr-l -at- lists -dot- techwr-l -dot- com>
Message-ID:
<0ADA9A22B5BC2147B360A22FD2BAD25CA91756 -at- RMGBEX01 -dot- rmg -dot- local>
Content-Type: text/plain; charset="us-ascii"

This is nothing like chapter numbers. This is the use of numerical
references to statutes. The legal statement, "This plea agreement is
dependent on statute 867-5309-J," is a form of technical documentation.

Wikipedia includes "legal pleadings" as a form of "technical content
created by technical writers." So do I.

Legal papers, just like government contract proposals, can mix technical
content with non-technical content.

> -----Original Message-----
> From: John Posada [mailto:jposada01 -at- yahoo -dot- com]
> Sent: Wednesday, March 28, 2007 2:30 PM
> To: Dan Goldstein; techwr-l -at- lists -dot- techwr-l -dot- com
> Subject: RE: The cost of inaccurate technical documentation
>
> What?
>
> That's like saying that because Stephen King puts numbers on his
> chapter, they're technical documents.
>
> It's not technical...just sloppy.
>

This message contains confidential information intended only for the use
of the addressee(s). If you are not the addressee, or the person
responsible for delivering it to the addressee, you are hereby notified
that reading, disseminating, distributing, copying, electronic storing
or the taking of any action in reliance on the contents of this message
is strictly prohibited. If you have received this message by mistake,
please notify us, by replying to the sender, and delete the original
message immediately thereafter. Thank you.



------------------------------

Message: 34
Date: Wed, 28 Mar 2007 11:44:35 -0700
From: "Gene Kim-Eng" <techwr -at- genek -dot- com>
Subject: Re: The cost of inaccurate technical documentation
To: "John Posada" <jposada01 -at- yahoo -dot- com>, "Dan Goldstein"
<DGoldstein -at- riverainmedical -dot- com>,
<techwr-l -at- lists -dot- techwr-l -dot- com>
Message-ID: <001e01c77169$22149ef0$3aa8a8c0 -at- genekoptx2>
Content-Type: text/plain; format=flowed; charset="iso-8859-1";
reply-type=original

I would go further than that. Legal documents are intended
to take simple concepts (justice, fair play, keeping one's
word, doing what's right and ethical), make them so
complicated that you can't possibly understand them and
don't dare try to without hiring a lawyer and enable those
who do hire lawyers to twist them around to suit any
desired interpretation. They're not just far apart from
technical documents, but are completely opposite in their
intended function.

Gene Kim-Eng


----- Original Message -----
From: "John Posada" <jposada01 -at- yahoo -dot- com>


>Tech documents take difficult concepts and describe them
> simply. Legal documents intentionaly allow for interpretation.



------------------------------

Message: 35
Date: Wed, 28 Mar 2007 13:45:32 -0600
From: "technical writing plus" <doc-x -at- earthlink -dot- net>
Subject: RE: The cost of inaccurate technical documentation
To: <techwr-l -at- lists -dot- techwr-l -dot- com>
Message-ID: <004901c77171$a7da1940$2101a8c0 -at- ThomJames>
Content-Type: text/plain; charset="US-ASCII"

Right. But I agree with John - I think that, although a legal document
may
have technical details and some of these technical details may be wrong,
the
lawyer who signs off on a legal document is saying something that is
quite
different from what a tech pubs manager is saying (when the tech pubs
manager signs off on something).

The lawyer, in part, is supposed to be representing the truth of all the
little facts to the court - and if the court later finds out that , in
fact
,this was not the case (that the lawyer did NOT have all the little
stuff
right) then the court is gonna (it's supposed to anyway) come back and
say
'somebody's gonna pay for this'.

This story about the telecommunications guy who benefited from the
errors is
an example of this process working itself out.

So if everybody understands what happened and why the guy got off and
everything, then why can the court not just go in there and say 'Well,
we
see what happened here, and this is what we're gonna do now to fix
things'?

The reason why, in my opinion, is that the court believes that those
people
should have gotten it right the first time.

Jim Jones http://tinyurl.com/4arjc

-----Original Message-----
The crucial missing information was the numerical citation of a statute.
Sounds pretty technical to me. And if the document had been written as
required, it would not have "allowed for interpretation."

Depending on its content, legal documentation can be a subset of
technical documentation -- just like chemical documentation, medical
documentation, traffic control documentation...

> -----Original Message-----
> From: John Posada
> Sent: Wednesday, March 28, 2007 2:08 PM
> To: Dan Goldstein; techwr-l -at- lists -dot- techwr-l -dot- com
> Subject: Re: The cost of inaccurate technical documentation
>
> > So that's just two errors, at an estimated cost of $50 to $87.5
> > million per error.
>
> That's not technical documentation...it's legal documentation.
> Lawyers don't employ technical writers to write that type of
> documentation...they use paralegals and law clerks.
>
> It's not the same thing. In fact, I'd say they couldn't be farther
> apart. Tech documents take difficult concepts and describe them
> simply. Legal documents intentionally allow for interpretation.
>

This message contains confidential information intended only for the use
of
the addressee(s). If you are not the addressee, or the person
responsible
for delivering it to the addressee, you are hereby notified that
reading,
disseminating, distributing, copying, electronic storing or the taking
of
any action in reliance on the contents of this message is strictly
prohibited. If you have received this message by mistake, please notify
us,
by replying to the sender, and delete the original message immediately
thereafter. Thank you.

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

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 &amp; 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 &amp; Manual: http://www.helpandmanual.com

---
You are currently subscribed to TECHWR-L as doc-x -at- earthlink -dot- net -dot-

To unsubscribe send a blank email to
techwr-l-unsubscribe -at- lists -dot- techwr-l -dot- com
or visit
http://lists.techwr-l.com/mailman/options/techwr-l/doc-x%40earthlink.net


To subscribe, send a blank email to techwr-l-join -at- lists -dot- techwr-l -dot- com

Send administrative questions to admin -at- techwr-l -dot- com -dot- Visit
http://www.techwr-l.com/techwhirl/ for more resources and info.



------------------------------

Message: 36
Date: Wed, 28 Mar 2007 14:47:27 -0400 (EDT)
From: "elizabeth j allen" <eja -at- samurai -dot- com>
Subject: Re: The cost of inaccurate technical documentation
To: "Gene Kim-Eng" <techwr -at- genek -dot- com>
Cc: Dan Goldstein <dgoldstein -at- riverainmedical -dot- com>,
techwr-l -at- lists -dot- techwr-l -dot- com
Message-ID: <28168 -dot- 209 -dot- 50 -dot- 91 -dot- 70 -dot- 1175107647 -dot- squirrel -at- 209 -dot- 50 -dot- 91 -dot- 70>
Content-Type: text/plain;charset=iso-8859-1

What about patent applications (legal) for semiconductors (technical)?

Elizabeth
--
Elizabeth J. Allen
Technical Writer
"Make everything as simple as possible, but not simpler." -- Albert
Einstein


Gene Kim-Eng said:
> I would go further than that. Legal documents are intended
> to take simple concepts (justice, fair play, keeping one's
> word, doing what's right and ethical), make them so
> complicated that you can't possibly understand them and
> don't dare try to without hiring a lawyer and enable those
> who do hire lawyers to twist them around to suit any
> desired interpretation. They're not just far apart from
> technical documents, but are completely opposite in their
> intended function.
>
> Gene Kim-Eng
>
>
> ----- Original Message -----
> From: "John Posada" <jposada01 -at- yahoo -dot- com>
>
>
>>Tech documents take difficult concepts and describe them
>> simply. Legal documents intentionaly allow for interpretation.




------------------------------

Message: 37
Date: Wed, 28 Mar 2007 12:01:41 -0700 (PDT)
From: John Posada <jposada01 -at- yahoo -dot- com>
Subject: Re: The cost of inaccurate technical documentation
To: elizabeth j allen <eja -at- samurai -dot- com>, Gene Kim-Eng
<techwr -at- genek -dot- com>
Cc: Dan Goldstein <dgoldstein -at- riverainmedical -dot- com>,
techwr-l -at- lists -dot- techwr-l -dot- com
Message-ID: <34796 -dot- 79592 -dot- qm -at- web35414 -dot- mail -dot- mud -dot- yahoo -dot- com>
Content-Type: text/plain; charset=iso-8859-1

That's not the type of document refered to in the original post. I'm
not discounting it because it had to do with legal writing. I'm
discounting it because it didn't have to do with technical writing.

--- elizabeth j allen <eja -at- samurai -dot- com> wrote:

> What about patent applications (legal) for semiconductors
> (technical)?


John Posada
Senior Technical Writer

"They say everyone needs goals. Mine is to live forever.
So far, so good."


------------------------------

Message: 38
Date: Wed, 28 Mar 2007 15:03:04 -0400
From: "Poshedly, Ken" <PoshedlyK -at- polysius -dot- com>
Subject: RE: The cost of inaccurate technical documentation
To: "Dan Goldstein" <DGoldstein -at- riverainmedical -dot- com>,
<techwr-l -at- lists -dot- techwr-l -dot- com>
Message-ID:
<737AFC2CC600B3419487F80030A84AC1015E3956 -at- kp04s152 -dot- KP04D1 -dot- local>
Content-Type: text/plain; charset="us-ascii"

Obviously no one else got it, but I did.

Hey Dan! Do ya think "Jenny" had anything to do with this contract?
<grin>

(What's he talkin' about?

"867-5309/Jenny" is a song written by Alex Call and Jim Keller and
performed by Tommy Tutone which peaked at Number 4 on the Billboard Hot
100 chart in 1982).

With two or so hours to go until 5 p.m., I know what _I'LL_ be humming
for awhile.

'Tis nice to see someone here still has a sly sense of humor.

-- Ken in Hotlanta






-----Original Message-----
From: techwr-l-bounces+poshedlyk=polysius -dot- com -at- lists -dot- techwr-l -dot- com
[mailto:techwr-l-bounces+poshedlyk=polysius -dot- com -at- lists -dot- techwr-l -dot- com] On
Behalf Of Dan Goldstein
Sent: Wednesday, March 28, 2007 2:42 PM
To: techwr-l -at- lists -dot- techwr-l -dot- com
Subject: RE: The cost of inaccurate technical documentation

This is nothing like chapter numbers. This is the use of numerical
references to statutes. The legal statement, "This plea agreement is
dependent on statute 867-5309-J," is a form of technical documentation.

(rest snipped)

__________________________

This e-mail message and any attachment contains private
and confidential information and is intended for the addressee only. If
you are not the intended recipient (or responsible
for delivery of the message to such person), please do not read, copy,
use or disclose this communication to others.
If you have received this message in error, please notify the sender by
replying to this message, and then delete it from your system.

Attachments: Please use our "Send us a file" link on
http://www.PolysiusUSA.com.

Thank you.
____________________
Polysius Corp.
Atlanta, Ga. USA
http://www.PolysiusUSA.com
Voice: 770-850-2000
Main Fax: 770-955-8789



------------------------------

Message: 39
Date: Wed, 28 Mar 2007 12:03:46 -0700 (PDT)
From: John Posada <jposada01 -at- yahoo -dot- com>
Subject: RE: The cost of inaccurate technical documentation
To: Dan Goldstein <DGoldstein -at- riverainmedical -dot- com>,
techwr-l -at- lists -dot- techwr-l -dot- com
Message-ID: <641535 -dot- 14746 -dot- qm -at- web35402 -dot- mail -dot- mud -dot- yahoo -dot- com>
Content-Type: text/plain; charset=iso-8859-1

We're going to have to agree to disagree. A cross-reference does not
a technical document make.

--- Dan Goldstein <DGoldstein -at- riverainmedical -dot- com> wrote:

> This is nothing like chapter numbers. This is the use of numerical
> references to statutes. The legal statement, "This plea agreement


John Posada
Senior Technical Writer

"They say everyone needs goals. Mine is to live forever.
So far, so good."


------------------------------

Message: 40
Date: Wed, 28 Mar 2007 12:13:43 -0700
From: "Guy K. Haas" <guy -at- hiskeyboard -dot- com>
Subject: Re: The cost of inaccurate technical documentation
To: techwr-l -at- lists -dot- techwr-l -dot- com
Message-ID: <460ABE67 -dot- 7070900 -at- hiskeyboard -dot- com>
Content-Type: text/plain; charset=ISO-8859-1; format=flowed

See http://www.876-5309.com/867-5309jenny.php

--Guy K. Haas
Software Exegete in Silicon Valley

Poshedly, Ken wrote:
> Obviously no one else got it, but I did.
>
> Hey Dan! Do ya think "Jenny" had anything to do with this contract?
> <grin>
>
> (What's he talkin' about?
>
> "867-5309/Jenny" is a song written by Alex Call and Jim Keller and
> performed by Tommy Tutone which peaked at Number 4 on the Billboard
Hot
> 100 chart in 1982).
>
> With two or so hours to go until 5 p.m., I know what _I'LL_ be humming
> for awhile.
>
> 'Tis nice to see someone here still has a sly sense of humor.
>
> -- Ken in Hotlanta
>
>
>
>
>
>
> -----Original Message-----
> From: techwr-l-bounces+poshedlyk=polysius -dot- com -at- lists -dot- techwr-l -dot- com
> [mailto:techwr-l-bounces+poshedlyk=polysius -dot- com -at- lists -dot- techwr-l -dot- com] On
> Behalf Of Dan Goldstein
> Sent: Wednesday, March 28, 2007 2:42 PM
> To: techwr-l -at- lists -dot- techwr-l -dot- com
> Subject: RE: The cost of inaccurate technical documentation
>
> This is nothing like chapter numbers. This is the use of numerical
> references to statutes. The legal statement, "This plea agreement is
> dependent on statute 867-5309-J," is a form of technical
documentation.
>
> (rest snipped)
>
> __________________________
>
> This e-mail message and any attachment contains private
> and confidential information and is intended for the addressee only.
If you are not the intended recipient (or responsible
> for delivery of the message to such person), please do not read, copy,
use or disclose this communication to others.
> If you have received this message in error, please notify the sender
by replying to this message, and then delete it from your system.
>
> Attachments: Please use our "Send us a file" link on
http://www.PolysiusUSA.com.
>
> Thank you.
> ____________________
> Polysius Corp.
> Atlanta, Ga. USA
> http://www.PolysiusUSA.com
> Voice: 770-850-2000
> Main Fax: 770-955-8789
>
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> 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 &amp; 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 &amp; Manual: http://www.helpandmanual.com
>
> ---
> You are currently subscribed to TECHWR-L as guy -at- hiskeyboard -dot- com -dot-
>
> To unsubscribe send a blank email to
> techwr-l-unsubscribe -at- lists -dot- techwr-l -dot- com
> or visit
http://lists.techwr-l.com/mailman/options/techwr-l/guy%40hiskeyboard.com
>
>
> To subscribe, send a blank email to techwr-l-join -at- lists -dot- techwr-l -dot- com
>
> Send administrative questions to admin -at- techwr-l -dot- com -dot- Visit
> http://www.techwr-l.com/techwhirl/ for more resources and info.
>
>
>


------------------------------

Message: 41
Date: Thu, 29 Mar 2007 07:15:09 +1000
From: Janice Gelb <janice -dot- gelb -at- sun -dot- com>
Subject: Re: Questions About Arbortext.
To: techwr-l -at- lists -dot- techwr-l -dot- com
Message-ID: <460ADADD -dot- 4070107 -at- sun -dot- com>
Content-Type: text/plain; charset=ISO-8859-1; format=flowed

richard -dot- melanson -at- us -dot- tel -dot- com wrote:
> Hello TechWR-L,
> I am on my second day at a new employer and they use Arbortext Editor
(Epic) and SiberSafe Client for all of their documentation creation. I
am pretty much a Framemaker writer, also having used Word and PageMaker
on some projects. Can I get anyones/everyones opinions on these
products, what are your experiences like, should I try and convince them
to go to Framemaker, should I run away screaming :-) Any input you can
give me on these products is greatly appreciated. Thank you.
>

We use Epic and although there is a learning
curve involved, it is a very powerful tool
that has worked well for us. However, we do
have a person on our team who helps support
it on site so it's not entirely maintenance
free. It produces purer SGML/XML than FrameMaker.

-- Janice

***********************************************************
Janice Gelb | The only connection Sun has with
janice -dot- gelb -at- sun -dot- com | this message is the return address


------------------------------

Message: 42
Date: Thu, 29 Mar 2007 07:16:36 +1000
From: Janice Gelb <janice -dot- gelb -at- sun -dot- com>
Subject: Re: Giving up on XML
To: techwr-l -at- lists -dot- techwr-l -dot- com
Message-ID: <460ADB34 -dot- 5010503 -at- sun -dot- com>
Content-Type: text/plain; charset=ISO-8859-1; format=flowed

Chris Borokowski wrote:
> I don't think the odds going down originates in the
> document being structured as much as that it's people
> finally paying attention to document structure.
>

That's partially it but the fact that the tool
will not *allow* them to produce structural errors
certainly contributes greatly. (Note that I'm
not talking about logical errors but purely
structural ones.)

-- Janice

***********************************************************
Janice Gelb | The only connection Sun has with
janice -dot- gelb -at- sun -dot- com | this message is the return address



------------------------------

Message: 43
Date: Wed, 28 Mar 2007 14:26:41 -0700
From: "Jennifer Baldwin" <jbaldwin -at- desertdocs -dot- com>
Subject: AuthorIT: Poor image quality for screen captures
To: <techwr-l -at- lists -dot- techwr-l -dot- com>
Message-ID:
<28B5ED7864CAA6459A98A11663F5934E7A0B07 -at- exch1 -dot- desertdocs -dot- com>
Content-Type: text/plain; charset="us-ascii"

I'm using AuthorIT to build a CHM, and I'm finding that the image
quality of my embedded screen captures is very poor. Specifically, it
seems to be reducing the number of colors. I've experimented a bit with
the format, but nothing I've tried seems to help.

It also does this when I publish to Word, but in that case, it's easy to
replace the images directly in Word. A band-aid solution, but a
solution nonetheless.

Has anyone else had this problem in AuthorIT, and if so, how did you
solve it?

Thanks for your help!


Jennifer Baldwin


------------------------------

Message: 44
Date: Wed, 28 Mar 2007 16:43:33 -0500
From: "Keith Hansen" <KRH -at- weiland-wfg -dot- com>
Subject: WinHelp: Default Topic, TOC, or Index Displayed?
To: <techwr-l -at- lists -dot- techwr-l -dot- com>
Message-ID:

<B4DBD1887147DE4BBAB1CBD0C1C99AD9AE9127 -at- wfg-win2k3-exch -dot- WFG -dot- LOCAL>
Content-Type: text/plain; charset="us-ascii"

Hello,

I'm working with WinHelp this week, something I rarely work with. I have
a very basic (and therefore probably stupid!) question, but here it is:

When a generated WinHelp file is opened, what factors determine whether
the Default Topic, TOC, or Index is first displayed?

Keith


------------------------------

Message: 45
Date: Wed, 28 Mar 2007 17:52:32 -0700
From: "Guy K. Haas" <guy -at- hiskeyboard -dot- com>
Subject: Yahoo Groups e-mail gone crazy?
To: TECHWR-L <techwr-l -at- lists -dot- techwr-l -dot- com>
Message-ID: <460B0DD0 -dot- 6000701 -at- hiskeyboard -dot- com>
Content-Type: text/plain; charset=ISO-8859-1; format=flowed

Anybody else getting 3, 4, 5, even 6 copies of e-mail messages from
Yahoo Groups to which they belong?

I certainly am, on several (but not all) Yahoo Groups.

Any news on its cause?

--Guy K. Haas
Software Exegete in Silicon Valley


------------------------------

Message: 46
Date: Wed, 28 Mar 2007 21:28:48 EDT
From: ArroxaneUllman -at- aol -dot- com
Subject: Re: Yahoo Groups e-mail gone crazy?
To: techwr-l -at- lists -dot- techwr-l -dot- com
Message-ID: <bd7 -dot- 113f12bb -dot- 333c7050 -at- aol -dot- com>
Content-Type: text/plain; charset="US-ASCII"

Yes, they are messed up. If you check them on the website
(_http://groups.yahoo.com_ (http://groups.yahoo.com) ) you'll see that
even there the messages
are posting several times. I've also noticed that in the last day or
two they
don't post immediately.

This is even better than Gmail randomly bouncing Yahoo Groups messages.

(Yes, that was sarcasm.)

Hope they fix it soon.

Arroxane





************************************** See what's free at
http://www.aol.com.


------------------------------

Message: 47
Date: Wed, 28 Mar 2007 22:37:20 -0500
From: quills -at- airmail -dot- net
Subject: Re: Questions About Arbortext.
To: techwr-l -at- lists -dot- techwr-l -dot- com
Message-ID: <p06240800c230e4a45dd5 -at- [192 -dot- 168 -dot- 1 -dot- 100]>
Content-Type: text/plain; charset="us-ascii" ; format="flowed"

At 7:15 AM +1000 3/29/07, Janice Gelb wrote:
>richard -dot- melanson -at- us -dot- tel -dot- com wrote:
>> Hello TechWR-L,
>> I am on my second day at a new employer and they use Arbortext
>>Editor (Epic) and SiberSafe Client for all of their documentation
>>creation. I am pretty much a Framemaker writer, also having used
>>Word and PageMaker on some projects. Can I get anyones/everyones
>>opinions on these products, what are your experiences like, should
>>I try and convince them to go to Framemaker, should I run away
>>screaming :-) Any input you can give me on these products is
>>greatly appreciated. Thank you.
>>
>
>We use Epic and although there is a learning
>curve involved, it is a very powerful tool
>that has worked well for us. However, we do
>have a person on our team who helps support
>it on site so it's not entirely maintenance
>free. It produces purer SGML/XML than FrameMaker.
>
>-- Janice

And don't forget to tell them what the output is and the ease of use
or need of a special technician to produce useable output in the
media of your choice, besides SGML or XML (text).

Scott


------------------------------

Message: 48
Date: Wed, 28 Mar 2007 22:53:30 -0700
From: "Paul Nagai" <naglists -at- gmail -dot- com>
Subject: Re: Questions About Arbortext.
To: TECHWR-L <techwr-l -at- lists -dot- techwr-l -dot- com>
Message-ID:
<9292e7b20703282253ye644ee1q2a0bed9046b56595 -at- mail -dot- gmail -dot- com>
Content-Type: text/plain; charset=ISO-8859-1; format=flowed

On 3/28/07, richard -dot- melanson -at- us -dot- tel -dot- com <richard -dot- melanson -at- us -dot- tel -dot- com>
wrote:
>
> Hello TechWR-L,
> I am on my second day at a new employer and they use Arbortext Editor
> (Epic) and SiberSafe Client for all of their documentation creation. I
am
> pretty much a Framemaker writer, also having used Word and PageMaker
on some
> projects. Can I get anyones/everyones opinions on these products, what
are
> your experiences like, should I try and convince them to go to
Framemaker,
> should I run away screaming :-) Any input you can give me on these
products
> is greatly appreciated. Thank you.
> Arbortext Editor (Epic)
> SiberSafe Client
>

I support an Arbortext "shop" using Editor, Styler, Publishing Engine,
and
other PTC/Arbortext products. I have no familiarity with SiberSafe (we
use
Documentum for our Content Management System). The Arbortext suite is
highly
capable and customizable. Editor is one of the premier XML editors. To
be
sure, it isn't the cheapest and initial deployments for a company often
require consulting services on top of the licensing. I don't think
Editor is
any simpler or harder to master than FrameMaker.

Further, it's possible that the way documents are authored using XML
will
have a greater learning curve than Editor (or any other XML authoring
tool).
You will likely lose a lot of control over formatting as well as how to
construct and organize a document. Some authors like the "freedom" from
those concerns, others hate it.

Recommending a conversion into XML *or* out of XML really ought to have
a
financial basis. By doing X, we will save $Y (or be able to deliver Z).
Can
you make an argument like that after two days on the job? I'd be
surprised
if anyone could who wasn't specifically brought in to support such a
change.

Finally, if you don't run screaming, figure out how to subscribe to
adepters, a mailing list specifically for users of Arbortext products. (
http://www.ptc.com/support will get you close, but I'm not sure how your
company manages PTC support IDs and/or adepters subscriptions.) Adepters
is
a very quiet (compared to techwr-l) but incredibly useful mailing list
with
a great bunch of folks who are equally eager to help with basic
questions as
they with esoteric ones.

--
Paul Nagai


------------------------------

_______________________________________________
You are currently subscribed to
TECHWR-L.
To unsubscribe send a blank email to
http://lists.techwr-l.com/mailman/listinfo/techwr-l
Send administrative questions to admin -at- techwr-l -dot- com -dot- Visit
http://www.techwr-l.com/techwhirl/ for more resources and info.

End of TECHWR-L Digest, Vol 17, Issue 29
****************************************
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

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 &amp; 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 &amp; Manual: http://www.helpandmanual.com

---
You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-

To unsubscribe send a blank email to
techwr-l-unsubscribe -at- lists -dot- techwr-l -dot- com
or visit http://lists.techwr-l.com/mailman/options/techwr-l/archive%40web.techwr-l.com


To subscribe, send a blank email to techwr-l-join -at- lists -dot- techwr-l -dot- com

Send administrative questions to admin -at- techwr-l -dot- com -dot- Visit
http://www.techwr-l.com/ for more resources and info.


Previous by Author: Re: Help!
Next by Author: RE: cross-cultural study on typefaces/fonts
Previous by Thread: Legal writing vs. documentation
Next by Thread: Provisions on the back of a contract; was: Re: Legal requirements for document accessibility?


What this post helpful? Share it with friends and colleagues:

Sponsored Ads


Sponsored Ads