On 12/30/24 19:40, Daniel K. wrote: > Alex requested min/max count of the elements, REQUIRED / OPTIONAL could > be replaced by one of "0..1", "0..n", "1..1", "1..n" that nicely > conveys both min/max and requirement level, albeit a bit less visually > distinctive.
I took a page from the regexp world, so in addition to "R" for required, I introduced "+" for "one or more" and "*" for "zero or more". > The ordered-ness of sibling elements is trickier to express in a compact > way, and I don't have a solution for it. > > In the multiple tables version it could be written before the table, and > not be in the table itself. I opted to just spell it out: The elements in this table MUST appear in the order listed. The table version did not turn out terrible. I've removed some content from the table rows and put the text below the tables. I think the readability improved, and by a stroke of luck none of the tables span a page break any more. Anyway, here's the result, one render for the list version, and one for the table version, there are .html versions as well. https://ietf.vendo.no/draft-ietf-dmarc-aggregate-reporting-list.txt https://ietf.vendo.no/draft-ietf-dmarc-aggregate-reporting-table.txt You can even see them side by side, thank you diffsite: https://diffsite.vendo.no/?url1=https%3A%2F%2Fietf.vendo.no%2Fdraft-ietf-dmarc-aggregate-reporting-list.txt&url2=https%3A%2F%2Fietf.vendo.no%2Fdraft-ietf-dmarc-aggregate-reporting-table.txt The WIP is here: https://github.com/d-javu/draft-ietf-dmarc-aggregate-reporting/tree/wip_prose There's a mix of things there, but the meat is after the "Local changes" commits, if you want to see more details. For my own sanity, I started by creating the list version from the current text, then filling in with missing pieces and comments from the XSD. I then made some edits and finally turned that result into the table version. If either version gets a thumbs up for form, I can clean up the patches and prepare a proper pull request. Daniel K. _______________________________________________ dmarc mailing list -- [email protected] To unsubscribe send an email to [email protected]
