RE: Validating manuals

[stevefjong -at- comcast -dot- net]

Michelle Vina-Baltsas wrote: 
> 
> > My company QA department wants to begin validating our 
> > operating instructions against the software user interface 
> > (UI) documents . I use FrameMaker 7.0 (unstructured) to 
> > create the manual and am using conditional text to manually 
> > trace the UI tags to the specific sentences/passages in the 
> > FrameMaker file. This is very time consuming and tedious. 
> > Does anyone have to do this type of tracing to a UI or to 
> > another document type? If so, how are you doing it? 

I think what you are describing is essentially a very thorough index. That does have value, of course, but I also think that rather than verifying that every UI feature is mentioned in the documentation, a much better use of QA's time for all concerned would be to validate that the statements in the documentation, and especially the procedures, are correct.

-- 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 *
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

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

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- 

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.