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

Re: new draft xml proc profiles doc

From: James Fuller <jim@webcomposite.com>
Date: Thu, 15 Dec 2011 12:37:15 +0100
Message-ID: <CAEaz5mvtRr818vB1=R_m+7jHLtEamU4YStWZ=CJi5rKoOxBvqw@mail.gmail.com>
To: "Henry S. Thompson" <ht@inf.ed.ac.uk>
Cc: Norman Walsh <ndw@nwalsh.com>, public-xml-processing-model-wg@w3.org
On Thu, Dec 15, 2011 at 12:18 PM, Henry S. Thompson <ht@inf.ed.ac.uk> wrote:
> I have to say I'm not happy with the new 'introductory' short paras at
> the beginning of each profile definition (2.1--2.4).

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.

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

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

Received on Thursday, 15 December 2011 11:37:45 UTC

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