Validating manuals

Mary Arrotti mary_arrotti at yahoo.com
Thu Apr 12 08:36:16 MDT 2007


I don't understand the value of validating operating instructions against other documents. Perhaps if you can explain this - you might get some suggestions on how to handle this. 
   
  In my experience, when a document is validated or tested it is against the actual UI. And it's not just the UI tags that are looked at - testers also look at whether tasks can be performed by following the instructions. Are the instuctions wrong, incomplete, confusing? 

Michelle Vina-Baltsas <Michelle_Vina-Baltsas at datascope.com> wrote:
  Hello all,

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? 

       
---------------------------------
Expecting? Get great news right away with email Auto-Check.
Try the Yahoo! Mail Beta.


More information about the TECHWR-L mailing list