W3C home > Mailing lists > Public > public-prov-wg@w3.org > March 2013

Re: staging: prov-aq, prov-xml and prov-overview

From: Stephan Zednik <zednis@rpi.edu>
Date: Mon, 4 Mar 2013 11:14:39 -0700
Cc: public-prov-wg@w3.org
Message-Id: <8B0D15D4-702B-4052-889F-B83D9A92E345@rpi.edu>
To: Luc Moreau <L.Moreau@ecs.soton.ac.uk>
Issue 1:

All normative representations must validate as one of the following: HTML 4.x, or some version of XHTML or XHTML+RDFa that is a W3C Recommendation. HTML5 is also permitted with the following limitations:
HTML5 is not yet permitted for Recommendations.
Inline markup for SVG 1.1 or MathML 2.0 is permitted but only with a (fallback) alternative.
If the HTML5 validator issues content warnings, the publication request must include rationale why the warning is not problematic.
Note: Please consider how your content will render in browsers that do not support HTML5.
Error The W3C Markup Validation Service was used for the validation of this document.
Solution:

When I staged PROV-XML last time I had to update the generated doctype to the following to get it to comply with pubrules.

<!DOCTYPE html PUBLIC '-//W3C//DTD XHTML+RDFa 1.0//EN' 'http://www.w3.org/MarkUp/DTD/xhtml-rdfa-1.dtd'>

The pubrules doc actually states that non-recommendation documents are allowed to have HTML5 doctype, but still generates an error for notes when the doctype is HTML5.  :-(

Since we aren't using RDFa currently I suggest we update the doctype to the following in the staged document.

<!DOCTYPE html PUBLIC '-//W3C//DTD XHTML 1.0 Transitional//EN' 'http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd'>

I will make the change.

Issue 2:

Every marked-up section and subsection of the document must have a target anchor. A section is identified by a heading element (h1-h6). The anchor may be specified using an id (or name if an a element is used) attribute on any of the following: the heading element itself, the parent div or section element of the heading element (where the heading element is the first child of the div or section), a descendant of the heading element, or an a immediately preceding the heading element.
Error, heading(s) found without a target anchor (specified using one of the allowed techniques): 
h2: A. XML Schema

Hmm, this looks like it should validate correctly.

This is the offending markup

<section class="appendix" id="prov-xml-schema"> 
<!--OddPage--><h2><span class="secno">A. </span>XML Schema</h2>

There is an "id" on the section and it is immediately followed by a heading element.

I will remove the comment and see if that results in compliance.

--Stephan

On Mar 4, 2013, at 8:00 AM, Luc Moreau <L.Moreau@ecs.soton.ac.uk> wrote:

> Hi Curt,
> 
> It fails pubrules compliance. Can you investigate?
> 
> http://services.w3.org/xslt?xmlfile=http%3A%2F%2Fservices.w3.org%2Ftidy%2Ftidy%3FdocAddr%3Dhttps%253A%252F%252Fdvcs.w3.org%252Fhg%252Fprov%252Fraw-file%252Fdefault%252Fxml%252Freleases%252FWD-prov-xml-20130312%252FOverview.html&xslfile=http%3A%2F%2Fservices.w3.org%2Fxslt%3Fxmlfile%3Dhttp%3A%2F%2Fwww.w3.org%2F2005%2F07%2Fpubrules%253Fuimode%253Dchecker_full%2526year%253D2013%2526docstatus%253Dord-wd-tr%2526rectrack%253Dno%2526prevrec%253Dnone%2526patpol%253Dw3c%2526normative%253Dyes%2526uri%253Dhttps%25253A%25252F%25252Fdvcs.w3.org%25252Fhg%25252Fprov%25252Fraw-file%25252Fdefault%25252Fxml%25252Freleases%25252FWD-prov-xml-20130312%25252FOverview.html%2526filterValues%253Dform%2526nscheckmanual%253D%2526display%253Dall%2526recursive%253Doff%2526recurse_auth%253Don%26xslfile%3Dhttp%3A%2F%2Fwww.w3.org%2F2005%2F09%2Fchecker%2Fframe.xsl%26display%3Dall%26recurse_auth%3Don&uimode=checker_full&filterValues=form&year=2013&docstatus=ord-wd-tr&rectrack=no&prevrec=none&patpol=w3c&normative=yes&doc_uri=https%3A%2F%2Fdvcs.w3.org%2Fhg%2Fprov%2Fraw-file%2Fdefault%2Fxml%2Freleases%2FWD-prov-xml-20130312%2FOverview.html&recursive=off&nscheckmanual=&display=all&recurse_auth=on
> 
> Luc
> 
> 
> 
> On 03/04/2013 02:01 PM, Curt Tilmes wrote:
>> On 03/04/2013 08:17 AM, Curt Tilmes wrote:
>>> On 03/04/2013 05:54 AM, Luc Moreau wrote:
>>>> We are missing 3 staged documents prov-aq, prov-xml and prov-overview.
>>>> 
>>>> I am planning to email the publication request to the web master
>>>> tomorrow night, but as I am away all day tomorrow,
>>>> I won't be able to do the necessary checks tomorrow. Can you stage your
>>>> documents
>>>> today and update the following page accordingly?
>>>> 
>>>> http://www.w3.org/2011/prov/wiki/PublicationRequestMarch12
>>> 
>>> I haven't heard from Stephan -- I'll give it a shot.  I see what you've
>>> done with phantomjs in the model Makefile, but I'm not sure the exact
>>> state of respec with the latest PROV-XML.  I'll try to do it, then you
>>> can look it over and make sure I didn't break anything.
>> 
>> Ok, I think I've got it staged here:
>> 
>> https://dvcs.w3.org/hg/prov/raw-file/default/xml/releases/WD-prov-xml-20130312/Overview.html 
>> 
>> I also updated the references to change all the "normative" ones
>> to "informative" since this is a note.
>> 
>> I added the links to the publication request.
>> 
>> Curt
>> 
>> 
> 
> -- 
> Professor Luc Moreau
> Electronics and Computer Science   tel:   +44 23 8059 4487
> University of Southampton          fax:   +44 23 8059 2865
> Southampton SO17 1BJ               email: l.moreau@ecs.soton.ac.uk
> United Kingdom                     http://www.ecs.soton.ac.uk/~lavm
> 
> 
> 
> 


Received on Monday, 4 March 2013 18:15:09 UTC

This archive was generated by hypermail 2.4.0 : Friday, 17 January 2020 16:51:32 UTC