#516 Documentation of <equiv> is confusing

AMBER
closed-fixed
5
2013-04-12
2013-01-25
Martin Holmes
No

The definition of element <equiv> originally had only pointers to four sections in chapter 22:

[22.4.4 Element Specifications 22.4.5 Attribute List Specification 22.4.6 Element Classes 22.4.7 Pattern Documentation]

but <equiv> seems to be mentioned only once, parenthetically, in the entire chapter. It's documented more fully in the CO chapter, so I've added the link there as the first pointer, but we need to decide if these original pointers are there because there was an intention to add text and examples to the TD chapter, and it never got done, or whether these original links are just misleading and should be removed.

Discussion

  • Martin Holmes
    Martin Holmes
    2013-01-25

    • summary: Documentation of <equiv> is very sparse --> Documentation of <equiv> is confusing
     
  • James Cummings
    James Cummings
    2013-04-09

    • Group: --> AMBER
     
    • assigned_to: Sebastian Rahtz
     
    • status: open --> closed-fixed
     
  • the Core and Tagdocs chapter have been updated to move the equiv/gloss/desc discussion largely to Tagdocs. links between chapters established, listRef in affected elements updated.