On 12/16/24 09:51, Alessandro Vesely wrote:
> That's notable and neatly structured.  Perhaps /Must contain/'s can be 
> slashes.

Thank you for your input.

I think you meant that it could be wrapped in underscores to be rendered
as italicized, but that only works in the HTML version, and looks messy
in the plain text version.

I opted to remove the words, but feel free to explain better what you
meant if I misunderstood and you want me to try something in particular.


> Would a table help to further reduce the "A begat B; B begat C" effect?
> Consider https://en.wikipedia.org/wiki/DMARC#Aggregate_reports

I may not fully have caught on here, and how to fix it. The nature of
describing XML in element order necessitates a bit of repetition.

I've experimented quite a bit the previous weeks, and I've prepared a
new render with a few variations.

https://ietf.vendo.no/draft-ietf-dmarc-aggregate-reporting-variants.txt

There's also an HTML version - change the extension if you want to see it.


3.1.1.1.  Prose version - must contain removed

Basically the same as before, but with the 'Must contain' introduction
removed. That wording certainly got a bit repetitive.


3.1.1.2.  Multiple tables version
3.1.1.3.  Single table version
3.1.1.4.  Single table version 2

The single table versions differ in how they communicate the level or
depth of the element in the XML hierarchy.

As you can see, I've tried a few things, but I think all of the table
variants suffer from the restrictions of tables when it comes to
formatting the details or nuances we describe for a particular element.
Especially 'record' and 'reason' seem to suffer.

At the end of 3.1.1.3, there's a few paragraphs that did not quite fit
in a particular place in the table. I don't think it fits perfectly at
the end either.

The tables also lose information on where the order of elements is
mandated by the XSD. There's no room for more columns to describe it.

I suggest we abandon the table-version, as I don't know how it can be
changed to work out.


Daniel K.

_______________________________________________
dmarc mailing list -- [email protected]
To unsubscribe send an email to [email protected]

Reply via email to