W3C home > Mailing lists > Public > public-xml-processing-model-wg@w3.org > December 2011

Re: new draft xml proc profiles doc

From: Henry S. Thompson <ht@inf.ed.ac.uk>
Date: Thu, 15 Dec 2011 12:16:07 +0000
To: James Fuller <jim@webcomposite.com>
Cc: Norman Walsh <ndw@nwalsh.com>, public-xml-processing-model-wg@w3.org
Message-ID: <f5bliqe81yw.fsf@calexico.inf.ed.ac.uk>
James Fuller <jim@webcomposite.com> writes:

> Admittedly they are more for human parsing, but as they precede the
> profile's precise definition I thought this was the right place for
> rationale to go as any clarification can be quickly addressed.

To me they appear so terse as to be perplexing, rather than helpful,
to the casual reader.

>> What problem are they meant to be addressing?
> With no intro text to any of the profiles, a reader skimming the
> document is forced to parse the entire document just to get an
> understanding of any single profile's essential nature.I see this text
> as a courtesy to the casual reader.

Fair enough.

>> If we have to have them, could they be collected together and moved
>> somewhere else?
> We could (assuming we give links as well to the formal profile
> description) but the further away we place the text from its formal
> description we then force the reader into the hyperlink square dance,
> which I try to avoid in small documents such as this.

I had in mind to just put them at the beginning of section 2, just
before section 2.1, perhaps in the following form:

  The four profiles defined here identify four increasingly rich
  profiles, in terms of kinds of processing and amount of information
  provided to applications:

  The Basic profile, adding only support for xml:base processing to
  the minimum required by the XML specification, in order to allow for
  correct resolution of relative URIs;

  The Id profile, which adds xml:id processing in order to identify
  IDs in the possible absence of complete attribute type declaration

  The External Declarations profile, which adds mandatory external
  markup declaration processing in order to guarantee all
  information-affecting declarations are processed;

  The Full profile, which adds xi:include processing, in order to
  transclude linked infosets as parsed XML or as text, recursively as

       Henry S. Thompson, School of Informatics, University of Edinburgh
      10 Crichton Street, Edinburgh EH8 9AB, SCOTLAND -- (44) 131 650-4440
                Fax: (44) 131 651-1426, e-mail: ht@inf.ed.ac.uk
                       URL: http://www.ltg.ed.ac.uk/~ht/
 [mail from me _always_ has a .sig like this -- mail without it is forged spam]
Received on Thursday, 15 December 2011 12:19:06 UTC

This archive was generated by hypermail 2.3.1 : Tuesday, 6 January 2015 21:32:50 UTC