[Bug 6911] Include xs:documentation in xs:assert examples

http://www.w3.org/Bugs/Public/show_bug.cgi?id=6911





--- Comment #3 from Pete Cordell <petexmldev@codalogic.com>  2009-05-15 10:04:11 ---
I agree there are a number of potential audiences for such documentation, and
it's hard to decide which audience should have priority.

Like Innovimax I think the ideal case would be to have something like an
xs:errorMessage element, e.g.:

<xs:complexType name="intRange">
 <xs:attribute name="min" type="xs:int"/>
 <xs:attribute name="max" type="xs:int"/>
 <xs:assert test="@min le @max">
  <xs:errorMessage>
   The value of the min attribute must be less
   than or equal to that of the max attribute.
  </xs:errorMessage>
 </xs:assert>
</xs:complexType>

As you can see I'm not sure whether this should be a child of xs:annotation or
just xs:assert, because I'm not sure it makes sense in all cases where
xs:annotation is used (haven't checked).

I imagine this sort of thing would have been easy to add 6 months ago, but
maybe we're past that point.  So Michael's suggestion not to include any
particular recommendations with regard to this and leave the community to
develop conventions would seem to be the best we can do at this stage.  


-- 
Configure bugmail: http://www.w3.org/Bugs/Public/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are the QA contact for the bug.

Received on Friday, 15 May 2009 10:04:20 UTC