Creating a section for each class

Creating a section for every class

Now that we have created the “Classes” navigation node, we are now going to proceed with the creation of a section for every class (as shown in Figures 39, 40 and 41).

Steps:

1. Select the “Classes” navigation node that you created in Figure 40.

2. Click on the icon.

3. Select “Section” from the list of possible production nodes and confirm by clicking on “OK”.

4. Change the name of the new section by simply selecting it, clicking on it once and entering the name “Class chapter”.

5. Define the “Title” property of the new section by entering the following information in the “Value” field associated with the “Title” property: "Class " + Name. Don't forget to leave a space after the word Class before the double quote, so as to have a space between the word itself and the class name which will appear after it in the generated documentation. For more information on entering J code, please see “Inserting J code”.

Note: When defining the properties of a production node, you must use double quotes to surround text that is not J code. In the example above, the word “Class” is not J code, and must, therefore, be surrounded by double quotes in the property value field.

Figure 39. Creating a chapter for each class

Continue by carrying out the operations illustrated in Figure 40 below.

Steps:

1. Select the “Class chapter” section that you created in Figure 39.

2. Click on the icon. The “Reference a template node” window then appears.

3. Select “Package documentation template/Package chapter/Description” to reference this node.

Figure 40. Selecting the “Description” node

4. Confirm by clicking on “OK”.

Figure 41. Referencing the “Description” paragraph for each class

For more information on referencing nodes, please see “Referencing nodes”.