Martin will update and improve http://www.tei-c.org/Guidelines/Customization/odds.xml#body.1_div.2 . Brett offered to read the revised text as a novice reader and offer suggestions if necessary.
Then Kevin will incorporate any points from http://www.tei-c.org/Guidelines/Customization/odds.xml#body.1_div.2 into http://www.tei-c.org/release/doc/tei-p5-doc/en/html/USE.html#MD that are not clearly tutorial points but belong in the Guidelines.
Added a prefatory section called "Key concepts".
Martin, does that mean you are finished with your part and this now goes over to me to do the second part?
No, not yet. I'm just getting started, really. I'll let you know when I finish it. Sorry it's taking so long -- fell to the bottom of the pile due to other more urgent tickets.
Any update on this?
Sorry, not recently. I've been too preoccupied with the text directionality stuff. I will get to it.
See https://sourceforge.net/p/tei/feature-requests/457/ for a particular point in the Guidelines related to ODDs that needs clarification. Perhaps handle both tickets at once.
FWIW, I am currently working on a an ODD Cheatsheet, which I will circulate for Council's comment as soon as it's available (hopefully this side of christmas)
Just noting that my work on this ticket is currently paused because of ongoing work on Pure ODD; it makes more sense to revise the Glines section on ODD when the Pure ODD work has settled down enough to be documented. If, as we hope, Pure ODD is simpler to use and easier to learn than the current system, the current content can be replaced with guidelines for using Pure ODD.