A reader should be able to create an EML annotation with examples, etc in section B alone (which currently is about half the total pages). Section C is for more in-depth info if they want it.
It should also be obvious to readers that they will need to have some external vocabs recommended. We have not come out and said that anywhere. nor have we started on a list recommendations, except de facto (in examples). My current feeling is that we add our example onts to the glossary (or appendix sub-section titled "Vocabs in examples"), but save formal recommendations for a separate doc.
enhance sub-section "organization of this doc" . describe A, B, C sections.
In each example's intro paragraph, use a list to highlight the three parts of the semantic statement. move parentheticals about external vocabs to appendix
introduce the "semantic statement" (plain english, no tech) right after the first code block showing an annotation node (on p2). link to below (addresses SC's comment).
add these terms to glossary (or other appendix section), link in text as much as possible:
Information Artifact Ontology (or section titled vocabs in examples)