Re: Concrete examples in XPointer specification

At 08:15 PM 5/9/00 +0200, Dario de Judicibus wrote:
> >From: "Eve L. Maler" <Eve.Maler@east.sun.com>
> >
> >This is a fair suggestion...  We've been discussing how to get more
> >examples in.  We might be able to add a few more for CR, but failing that,
> >we're planning to collect examples and put them on a public Linking Group
> >web site.
> >
> >        Eve
>
>That is a nice idea, but I would distinguish between sample code for 
>tutorials or advanced learning, and simple inline examples helpful to 
>clarify concept that, otherwise, might result too abstract to readers.
>
>Sample repositories might be useful not only for XLL, but for XSL and XML 
>Schema too. There is some public stuff around, but they tends to be 
>obsolete because of speed of changes in draft standards.
>
>What I suggested was to add a line of code after definitions or 
>complicated statements in CR, to facilitate understanding. For example, is
>
>#xpointer(p/text()/10)
>
>a correct way to address the character-point after J in
>
><p>Dario de Judicibus</>
>
>? Reading the draft it looks correct, but there is no explicit statement 
>that /n notation can be used for indexing character-points as well as 
>node-points.

I agree that you make good points here.  Of course, we want the spec to be 
as clear as possible.  Since we're trying to do the steps that lead to 
Candidate Recommendation now, I'm not sure how much freedom we have to add 
new text, but I will check.  We might need to publish additional examples 
on the web site first, and then incorporate them as editorial fixes post-CR.

         Eve
--
Eve Maler                                    +1 781 442 3190
Sun Microsystems XML Technology Center    elm @ east.sun.com

Received on Wednesday, 10 May 2000 13:24:18 UTC