Working with Embedded Documentation
Each delivered Change Assistant template comes with embedded documentation to help guide you through an update or upgrade job, especially for manual steps. Typically, full upgrades have significantly more documentation than updates.
The documentation for any chapter, task, or step resides in a separate HTM file with the same name as the template element. A master HTML file stores the compilation of the separate HTM files displayed in an order matching the template.
When working with Change Assistant documentation, you:
Set the documentation directory.
Create and edit documentation.
Setting the Documentation Directory
You set the documentation directory before an upgrade and prior to customizing documentation. The documentation directory contains the documentation HTM files.
To set the documentation directory:
Select Edit, Set Documentation Directory.
Navigate to the directory where you want to store the documentation.
Viewing the Documentation
To view the embedded documentation associated with a particular template element:
Select the template node.
View the documentation in the documentation box.
To view the compiled documentation:
Navigate to the documentation directory.
Open the template_name.HTM file.
Creating and Editing Documentation
To create or edit documentation:
Select the desired element node.
In the edit box on the Edit Documentation dialog box, insert your cursor, and add new content or modify existing content.
Click Attach to incorporate additional files, such as graphics or additional text files. Attaching files moves that file into the documentation directory and inserts a link to that file in the embedded documentation.
After modifying any documentation for individual template elements, selectto compile the individual documentation changes into the master HTM file.