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:Live Linx ConteX? or something similar? From:KAstry -at- lightbridge -dot- com To:techcomm-discuss -at- stcrmc -dot- org, "mailto:hatt"@yahoogroups.com, TECHWR-L -at- LISTS -dot- RAYCOMM -dot- COM Date:Thu, 4 Mar 2004 10:57:51 -0700
We're trying to come up with an easy solution for our SMEs to provide us with
upgrade and integration docs, and I'd like to hear about your experiences with
Live Linx ConteX or a similar, perhaps XML-based product. Our situation:
--Our SMEs need to build and track upgrade docs for different flavors of our
software releases, which involves incorporating some 3rd party
patches/enhancements with new software that we've developed, and making sure all
parts play together nicely.
--The content of the upgrade docs tends to be 70% identical from one release to
another, but not always the same 70% for each doc.
--The software and upgrade docs must go through review and testing by QA, so
edits must be easily made to the doc without having to rebuild the "book" from
--The SMEs then give us the doc to format and produce, at the last minute, as
Right now we're using Word for this, and I know our SMEs would like to stick
w/Word (which may rule out AuthorIt). Whatever solution we go with must be easy
to learn and use by systems integrators/programmers/engineers--non-documentation
specialists. And it needs to be inexpensive and handle collaborative authoring.
Suggestions? Experiences? Thank you--
Kristy Lantz Astry
Sr. Documentation Specialist
320 Interlocken Parkway
Broomfield, CO 80021
kastry -at- lightbridge -dot- com