Working with Embedded Wizard: Extracting project documentation

Embedded Wizard is able to automatically extract from your project the available documentation and to store it as a set of *.HTML files. This feature is as such a useful supplement if you want to share your development with other members of your team or your customer expects the software being delivered with the corresponding documentation.

During the documentation extraction Embedded Wizard evaluates your project and the dependencies between all project members. Knowing this information and the description you have eventually specified for the members, Embedded Wizard generates chapters describing individual project members as well as the relations between them presented in inheritance and class diagrams. Hyperlinks permit the user to navigate conveniently in the resulting document. The following screenshot demonstrates how the generated documentation looks like:

Description attribute

The resulting documentation is built from the relations existing between project members and the individually specified member description. Almost every project member exposes the attribute Description. The text you enter in this attribute is automatically taken over into the resulting document. Thus it is essential to provide description for your project members in order to obtain documentation with reasonable quality.

Start documentation extraction

To start the documentation extraction select in the menu Build the command Extract documentation .... Thereupon the Extract documentation dialog appears where you can configure and start the operation.

View and deploy the documentation

To view the generated *.HTML files you can use any WebBrowser. If you have enabled the option Include navigation area, the Log window additionally provides a message to directly open the just generated documentation in a WebBrowser. You can simply double-click on this message:

Also possible, by using the Windows File Explorer you can navigate to the destination directory and copy or see the generated HTML files individually.

Customize the appearance of the generated documentation

The appearance (fonts, colors, etc.) of the generated documentation is controlled by a _stylesheet.css file found in the directory where all related *.HTML files are stored. If desired, you can modify this CSS file.