The notes tag indicates that a particular documentation topic contains annotations. It consists of one or more note tags, no other tags are allowed They serve as annotations to the documentation, usually for the benefit of the documentation writer.
As such, notes are by default not included in the final documentation, but they can be added to them with the –emit-notes command-line option.
Notes can appear below the module, topic and element tags.
For an explanation of what can appear inside the note tag itself, see note (??).
See also: note (??), module (191), topic (220) and element (173).