ubl-ndrsc — archive

[ubl-ndrsc] Embedded documentation writeup draft

From: Eve Maler
To: [email protected]
Date: Mon, 05 Aug 2002 16:44:00 -0000

MHonArc v2.5.2 -->

ubl-ndrsc message

Subject: [ubl-ndrsc] Embedded documentation writeup draft

From: "Eve L. Maler" <[email protected]>
To: [email protected]
Date: Mon, 05 Aug 2002 16:43:58 -0400

Please find below Arofan's draft writeup on embedded documentation, and 
also some issues he's raised on the subject.  Let's discuss on Wednesday 
(look for an agenda from me by the end of the day Tuesday...).

Another question to consider on embedded documentation: Should we be 
using xsd:documentation or xsd:appinfo?  Here's some background from a 
thread between Arofan and me:

Eve:
"Another question that came up when I presented UBL last week was: Why 
xsd:documentation rather than xsd:appinfo?  I couldn't give the 
questioner a good answer to this one...  Especially if we imagine that 
non-normative schemas will be produced directly from our normative XSD 
rather than from the spreadsheet (and there's a lot to be said for that, 
since it would be an XML->XML transformation rather than a 
spreadsheet->XML one), xsd:appinfo could make a lot of sense."

Arofan:
"As for AppInfo - well, hey - I thought it was documentation originally, 
but it could as easily be AppInfo, I suppose. On what basis should we 
make this decision? There isn't a difference technically, if I remember 
right. If we can determine that one or the other is more correct, then 
that's what I'll vote for. I guess we should put this to the group, no?"

	Eve