Re: Examples in the spec

[James Clark <jjc@jclark.com>]

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
>
>