Re: Testable assertion tagging for W3C specifications

Based on Alex Rousskov's latest description, I surmise that he is
proposing:

1. Spec authors take no special action.
2. Test case authors cite the specs using whatever crude means are
   available. They may have to use byte counts to point at particular
   characters.
3. Somebody applies a process which takes as input the specs and the
   test cases (or whatever is doing the citing) and produces new
   versions of the specs with extra footnote marks. Each test case puts
   its own footnote marks.
4. The reader must read the specially-processed version of the spec.
   upon encountering a footnote mark, s/he may click on it and see the
   test case that supplied that mark.

The description of this capability:
> >  - we want to provide reverse index where a reader can
> >    read the specs and get "one-click" access to
> >    test cases that correspond to the sentences she is reading
I took that to mean that one click would fetch all the tests, but I
now think it means that you may have several marks side-by-side, and
you must click on each mark to see one test. So the special edition
of the spec might look like this:

If the attribute name matches PrefixedAttName, then the NCName gives
the namespace prefix, used to associate element and attribute names
with the namespace name in the attribute value in the scope of the
element to which the declaration is attached. @@@@@@@@@@@@In such
declarations, the namespace name may not be empty.

Each "@" would link to a separate test case.

Alex: Is this what you meant?
.................David Marston

Received on Thursday, 30 May 2002 13:34:38 UTC