v3 guidance received
This is a summary of guidance received; it is not a comprehensive list.
“–>” indicates the takeaways of the guidance received.
“See” indicates where this info is captured in more detail. (All items are already captured in this wiki, the schema documentation, or the FAQ.)
artwork vs. sourcecode determination (revisited Sept 2020)
guidance on <contact> element (April and Dec. 2020)
questions about <relref> handling and entity handling (Aug 2020)
general guidance on choosing the right element for specific content (June 2020)
guidance on <svg> attributes (June 2020 questions from Jean)
using <ul empty=“true”> to get indentation should be avoided (June 2020)
→ In some cases, use other markup to attain the desired effect (indent attribute was added to <t>).
→ It’s not always nec. to replicate the indentation in the original I-D. (editorial judgment)
-
questions about postal address handling (April and July 2020)
locations where non-
ASCII chars may appear (March 2020)
–> Besides <author> and <contact>'s child elements and attributes, non-
ASCII chars can appear in <artwork>, <sourcecode>, and <u>.
-
guidance on <br> vs. &br; (Jan and May 2020)
OK to leave <sourcecode>'s type empty? (Jan 2020)
What element should be used for equations or formulas? (Jan 2020)
how to set <artwork> type (Nov 2019)
guidance on nested lists (July 2019)
What is best practice for <refcontent> usage (as opposed to <seriesInfo>)? (Nov 2019)
What is best practice for <aside> in light of the definition in 7991 as “a container for content that is semantically less important or tangential to the content that surrounds it”? (April 2021)
What is the recommended placement for <seriesInfo>? (Sept 2019 and June 2020)
inside <front> or outside <front>?
schema allows either placement. (June 2020: better for it to be outside <front>, matching v2)
-