Help on using the <commentary> tag

The commentary tag is used to provide supplementary commentary for exercises and their solutions. This commentary is associated with the exercise itself and may present itself in the form of a follow-up question, explanation, or variation of the exercise.

Example

This CNXML:


<exercise id="gravity-exercise">
  <problem id="gravity-problem">
    <para id="prob_1">
      If a golf ball and a feather were dropped at 
      the same time from 10 feet, which would 
      strike the ground first?
    </para>
  </problem>
  <solution id="gravity-solution">
    <para id="sol_1">
      The golf ball would hit the ground first.
    </para>
  </solution>
  <commentary id="gravity-commentary" 
    type="follow-up">
      How would this problem have been different
      if the experiment was conducted in a vacuum?
  </commentary>
</exercise>

Results in this display:

Exercise 1

If a golf ball and a feather were dropped at the same time from 10 feet, which would strike the ground first?

[ Show Solution ]

How would this problem have been different if the experiment was conducted in a vacuum?

Attributes(what's this?)

type (optional): Defines the type of commentary. Type can be any user-defined value that reflects the purpose of the commentary.
id (required): A unique identifier, whose value must begin with a letter and contain only letters, numbers, hyphens, underscores, colons, and/or periods (no spaces).

Using the <commentary> tag

Description

Example

Exercise 1

Solution

Attributes(what's this?)

Children(what's this?)

Parents(what's this?)