Re: Error codes drafts

Norm Tovey-Walsh writes:

> Hello,
>
> There are now three different error codes drafts, representing four
> different possible approaches to adding error codes to the spec.
>
> 1. PR #54, https://github.com/invisibleXML/ixml/pull/54
>    Rendered at https://ndw.github.io/ixml/errcodes.html
>
>    This draft inlines the error messages into the running prose:
>
>    ...

> 2. PR #65, https://github.com/invisibleXML/ixml/pull/65
>    Rendered at https://ndw.github.io/ixml/errcodes2.html
>
>    This draft makes the error codes superscripts. ...

> 3. PR #74, https://github.com/invisibleXML/ixml/pull/74
>    Rendered at https://ndw.github.io/ixml/errcodes3.html
>
>    ... Rather than
>    placing the error codes in a superscript, it places them
>    parenthetically.
>
>    ...

> 4. PR #74, https://github.com/invisibleXML/ixml/pull/74
>    Rendered at https://ndw.github.io/ixml/errcodes3.html
>
>    This proposal is an extension of proposal 3. In addition to placing
>    the error codes parenthetically in the prose, it adds the full error
>    text below the paragraph in which the error(s) occur. ...

For what it's worth, I think my preferences are 1 or 4, 3, 2, in that
order.  Version 1 is tied with version 4.

Michael

-- 
C. M. Sperberg-McQueen
Black Mesa Technologies LLC
http://blackmesatech.com

Received on Sunday, 17 April 2022 15:19:34 UTC