OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.

 


Help: OASIS Mailing Lists Help | MarkMail Help

relax-ng message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [Elist Home]


Subject: Re: Examples in the spec


My vote would be for using the same source document to tie data model, simplification, and inference rules together in three examples. It is easier and more enjoyable to eat a large, good meal in courses. P^)
-Mike
---------- Original Message ----------------------------------
From: James Clark <jjc@jclark.com>
Date: Thu, 26 Jul 2001 13:08:40 +0700

>I agree with the need for examples in these 3 areas.  Murata-san's example 
>actually covers the data model as well, which raises the following 
>question.  Is it better to have one big example that covers both the data 
>model, simplification and the inference rules (probably in an Appendix), or 
>is it better to divide up the example amongst the separate sections (but 
>use the same source document throughout, so that users can see how it all 
>ties together). I think it's probably better to divide it up.  What do you 
>think?
>
>--On 26 July 2001 01:51 -0400 Michael Fitzgerald <mike@wyeast.net> wrote:
>
>> I would be very happy to see examples added in at least three places in
>> the spec.
>>
>> 1. An example at or near the end of section 2, "Data Model." This has
>> been discussed and I think James agrees.
>>
>> 2. An example at or near section 5, "Simple Syntax." I would suggest a
>> before-and-after example showing the simplification on actual markup.
>> This has not been discussed.
>>
>> 3. An example as Makoto demonstrated that illustrates a few inference
>> rules with concomitant markup. I like it a lot and I hope the TC agrees.
>> It could be an informative appendix, as Makoto suggests, or follow
>> section 7 or ?
>>
>> I would be delighted if these three example made it into the spec.
>>
>> Mike
>>
>> ------------------------------------------------------------------
>> To unsubscribe from this elist send a message with the single word
>> "unsubscribe" in the body to: relax-ng-request@lists.oasis-open.org
>>
>>
>
>
>
>
>


[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [Elist Home]


Powered by eList eXpress LLC