having trouble making changes to the handbook

[Ernie Luzar]

Trevor Roydhouse wrote:
> Ernie Luzar wrote on 24/05/2017 03:43:
>> One last thing. When I go to edit the chapter.xml content I see the
>> text wraped in notation. Is there a special term that this "notation"
>> is normally referred by?
> 
> Are you referring to the tags which comprise the XML markup?
> 

Yes the "chapter.xml" files with content enclosed with <  >  like
<indexterm>  </indexterm>
Is this markup notation referred to as "tags" or is "markup notations" 
the correct way to reference them as a group?

Where are the intended usage meanings of all the different combinations 
of markup notations documented at?  Looking at the online handbook and 
back tracking to the xml markup notation is not a easy method of 
identifying the xml markup notation to use to add new information to the 
handbook information.

Now here is the really puzzling question. How would I write 
documentation about these xml markup notations showing the real xml 
markup notation code in the doc without it being interpreted as 
something that gets converted? example

<para>Here is what the xml markup notation code looks like;<title>As 
seem in the raw code.</title></para>

which when seen from a browser would show as

Here is what the xml markup notation code looks like; <title>As seem in 
the raw code.</title>