Hi Pete,
This looks fine to me - clear and to-the-point. Please make the
addition at your convenience.
Tom
On Mon, Mar 22, 2010 at 04:13:24PM +0000, Pete Johnston wrote:
> Content-Type: text/plain; charset="us-ascii"
> Date: Mon, 22 Mar 2010 16:13:24 +0000
> Sender: DCMI Architecture Forum <[log in to unmask]>
> From: Pete Johnston <[log in to unmask]>
> Subject: Re: Problem with DC-HTML profile document?
> To: [log in to unmask]
>
> Tom said:
>
> > I agree with your preference. It is the sort of change for which we have
> > used Errata notes in the past -- a practice about which I have heard no
> > complaints. It fixes the problem with the least disruption.
>
> and
>
> > Rather than bury the point in an appendix, I would suggest adding a
> > sentence of explanation about the issue near the top of the document,
> > e.g., at the end of the introduction. This sentence could be clearly
> > marked and dated as an addition and could a link to the Errata section,
> > which could marked with an anchor following [2] - e.g., "#errata" - with a
> > full description of changes made.
>
> I said:
>
> > Does this change the answer to the question of whether we should create a
> > new version of the profile?
>
> In the absence of any further comments, I propose editing the current document (i.e. not creating a new version) to add a new sub-section 1.2 saying the following:
>
> ====
> 1.2 GRDDL, XML and Entity References (Added nn March 2010)
>
> The GRDDL specification notes that a GRDDL XML processor might not process DTDs and schemas referenced by a document, and recommends:
>
> <blockquote>
> Document authors, particularly XHTML document authors, who wish their documents to be unambiguous when used with GRDDL should avoid dependencies on an external DTD subset; specifically:
>
> * Explicitly include the XHTML namespace declaration in an XHTML document, or an appropriate namespace in an XML document.
> * Avoid use of entity references, except those listed in section 4.6 of the XML specification.
> * And, more generally, follow the rules listed for the standalone document validity constraint.
> </blockquote>
>
> So XHTML documents using the DC-HTML profile should <b>not</b> include entity references other than the five predefined by the XML specification itself (&, <, >, ', "). Numeric character references (like © or © for the copyright sign) <b>are</b> supported.
> ====
>
> (and adding a note to the Errata at the end to indicate the change).
>
> Pete
--
Thomas Baker <[log in to unmask]>
|