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.
Subject:RE: Need SME Review? Try this From:John Posada <JPosada -at- book -dot- com> To:"TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com> Date:Fri, 1 Nov 2002 11:27:08 -0500
> At my current employer, the previous writer (small company,
> one writer) was able to get by without reviews because her
> grasp of the products was so complete. When it was time to
Understanding the product is not the problem that I'm try to address....I
have other ways I'm addressing that. The problem is that this isn't a
product, but a system...much of the entire system behind the B&N.com web
site. This is a dynamic system that is continually modified... directories
change, sources/destinations of files change, versions of configurations
change. This is the type of stuff I'm asking the developers to relate to me.
I try to keep track of this by reading emails between developers posted to
an internal group that is used by the developers to let each other know what
is being changed. I have shortcuts to the .cfg and .ini files where these
changes are placed and compare them regularly. I attend most of the daily
staff meetings. However, some changes are more obscure, yet just as
important (an example being changes to the transactional Remote Function
Calls (tRFC) for SAP connection, or changes to NATs that are used by the
AS400s to get through the firewalls, or the IP addresses for any one of 50
network servers). It is these changes that I want them to look for in the
documentation and submit revisions.
John Posada
Senior Technical Writer
Barnes&Noble.com
jposada -at- book -dot- com
212-414-6656
"Be accurate...the 4am wakeup call you prevent could be your manager's"
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Buy ComponentOne Doc-To-Help 6.0, the most powerful SINGLE SOURCE HELP
AUTHORING TOOL for MS Word. SAVE $100 on the full version and $50 on the
upgrade. Offer ends 10/31/2002 (code: DTH102250). http://www.componentone.com/d2hlist1002
All-new RoboHelp X3 is now shipping! Get single sourcing, print-quality
documentation, conditional text and much more, in the most monumental
release ever. Save $100! Order online at http://www.ehelp.com/techwr-l
---
You are currently subscribed to techwr-l as:
archive -at- raycomm -dot- com
To unsubscribe send a blank email to leave-techwr-l-obscured -at- lists -dot- raycomm -dot- com
Send administrative questions to ejray -at- raycomm -dot- com -dot- Visit http://www.raycomm.com/techwhirl/ for more resources and info.
