Re: June 18 call summary: resolved to publish use-cases-and-requirements

Jeremy,

- Have checked out the repo, made some changes on the index file to respond to your various questions on the references (I have also added the necessary references). I think that, from that point of view, it is ready to go. I pushed this into the pwd-ucr branch.
- I have also looked at the checker's response, namely the 'manual' checks, and I did not find any problems

I would think that you can go ahead with the latest version, merge and generate the final Overview.html file in the gq-pages branch. Once this is done, I can then copy them to the final place. I have sent a publication request to the webmaster.

Anything else you need me for before I take over to put this up onto the W3C?

Cheers

Ivan


On 20 Jun 2014, at 17:11 , Tandy, Jeremy <jeremy.tandy@metoffice.gov.uk> wrote:

> Ivan - thanks for initial comment. We'll merge pwd-ucr into gh-pages once we're happy. Until then, I fix `index.html` in gh-pages branch and then generate a new `Overview.html` (from respec) which I commit into pwd-ucr.
> 
> Jeremy
> 
>> -----Original Message-----
>> From: Ivan Herman [mailto:ivan@w3.org]
>> Sent: 20 June 2014 15:40
>> To: Tandy, Jeremy
>> Cc: Dan Brickley; Jeni Tennison; Eric Stephan; Davide Ceolin; W3C CSV
>> on the Web Working Group
>> Subject: Re: June 18 call summary: resolved to publish use-cases-and-
>> requirements
>> 
>> 
>> On 20 Jun 2014, at 13:51 , Tandy, Jeremy
>> <jeremy.tandy@metoffice.gov.uk> wrote:
>> 
>>> Hi Dan & Ivan -
>>> 
>>> Thanks for your help.
>>> 
>>> Pending resolution of the [request sent to Ivan this morning][1] I
>> have managed to run through the entire publishing process to generate
>> the [`Overview`][2] and [`diff`][3] html pages via RawGit.
>>> 
>>> Regarding the [PubRules][4] validation (see [results][5])...
>>> - I fixed some nested anchor elements caused by using `<a>` within a
>> figure caption that then got wrapped in another `<a>` by respec, and
>> found a pair of unescaped `<` and `>` characters ... nothing much.
>>> - HTML validation still complains (with a warning) that the <bdi>
>>> element is not generally supported
>> 
>> That is warning. We should get that through with the webmaster:-)
>> 
>>> - I get an error on the boiler plate regarding the Patent Policy ...
>>> even though this is generated by respect :-(
>> 
>> Hm. I will have to look at that next week, I vaguely remember some
>> issues with the checker
>> 
>>> - I get a number of HTTP 404 errors on URLs in the document; but
>> these
>>> are all from with <pre> elements (e.g. literal examples) and we
>> agreed
>>> last time that these didn't count
>> 
>> Yes. We will have to document that to the webmaster
>> 
>>> - I get an HTTP 403 error on
>> http://www.nhs.uk/aboutnhschoices/contactus/pages/freedom-of-
>> information.aspx - but this resolves fine for me in my browser!
>>> 
>> 
>> Yes, there are sites that put in obstacles for robots. As long as this
>> is documented that it works...
>> 
>> 
>>> Once we're happy that the UCR document is in its final state, I'll
>> run though this process again ... it didn't take very long.
>> 
>> But we should merge it to the main branch, and not keep it in the
>> separate one. The whole purpose is that whatever changes you do should
>> be there once and for all and you would not have to repeat them next
>> time:-)
>> 
>>> 
>>> Also, I'd appreciate an experienced assessment on the things that
>> PubRules says I need to manually verify. Most of them seem OK - but
>> what do I know!?
>>> 
>> 
>> I will do that next week.
>> 
>> Ivan
>> 
>>> Best Regards, Jeremy
>>> 
>>> PS. I've added a few amendments to the [publishing process][6] to
>> explain how to use the RawGit service.
>> 
>> Thanks! We and others will, hopefully profit from it...
>> 
>> I can contact the webmaster with an agreement for the 1st of July, but
>> I have to know whether the UCR is the only document to be published on
>> that day!
>> 
>> 
>> Ivan
>> 
>>> 
>>> [1]:
>>> http://lists.w3.org/Archives/Public/public-csv-wg/2014Jun/0131.html
>>> [2]:
>>> https://rawgit.com/w3c/csvw/pwd-ucr/publishing-snapshots/WD-ucr-2014-
>> 0
>>> 7-01/Overview.html
>>> [3]:
>>> https://rawgit.com/w3c/csvw/pwd-ucr/publishing-snapshots/WD-ucr-2014-
>> 0
>>> 7-01/diff-20140327.html
>>> [4]: http://www.w3.org/2005/07/pubrules
>>> [5]:
>>> 
>> http://services.w3.org/xslt?xmlfile=http%3A%2F%2Fservices.w3.org%2Ftid
>>> 
>> y%2Ftidy%3FdocAddr%3Dhttps%253A%252F%252Frawgit.com%252Fw3c%252Fcsvw%2
>>> 52Fpwd-ucr%252Fpublishing-snapshots%252FWD-ucr-2014-07-
>> 01%252FOverview
>>> 
>> .html&xslfile=http%3A%2F%2Fservices.w3.org%2Fxslt%3Fxmlfile%3Dhttp%3A%
>>> 
>> 2F%2Fwww.w3.org%2F2005%2F07%2Fpubrules%253Fuimode%253Dchecker_full%252
>>> 6year%253D2014%2526docstatus%253Dord-wd-
>> tr%2526rectrack%253Dyes%2526pr
>>> 
>> evrec%253Dnone%2526patpol%253Dw3c%2526normative%253Dyes%2526uri%253Dht
>>> tps%25253A%25252F%25252Frawgit.com%25252Fw3c%25252Fcsvw%25252Fpwd-
>> ucr%
>>> 25252Fpublishing-snapshots%25252FWD-ucr-2014-07-
>> 01%25252FOverview.html
>>> 
>> %2526filterValues%253D%2526nscheckmanual%253D%2526display%253Dall%2526
>>> 
>> recursive%253Doff%2526recurse_auth%253Don%26xslfile%3Dhttp%3A%2F%2Fwww
>>> 
>> .w3.org%2F2005%2F09%2Fchecker%2Fframe.xsl%26display%3Dall%26recurse_au
>>> th%3Don&uimode=checker_full&filterValues=&year=2014&docstatus=ord-wd-
>> t
>>> 
>> r&rectrack=yes&prevrec=none&patpol=w3c&normative=yes&doc_uri=https%3A%
>>> 2F%2Frawgit.com%2Fw3c%2Fcsvw%2Fpwd-ucr%2Fpublishing-snapshots%2FWD-
>> ucr
>>> -2014-07-
>> 01%2FOverview.html&recursive=off&nscheckmanual=&display=all&r
>>> ecurse_auth=on
>>> [6]: https://github.com/w3c/csvw/blob/gh-pages/publishing_process.md
>>> 
>>>> -----Original Message-----
>>>> From: Dan Brickley [mailto:danbri@google.com]
>>>> Sent: 19 June 2014 19:58
>>>> To: Tandy, Jeremy
>>>> Cc: Ivan Herman; Jeni Tennison; Eric Stephan; Davide Ceolin; W3C CSV
>>>> on the Web Working Group
>>>> Subject: Re: June 18 call summary: resolved to publish use-cases-
>> and-
>>>> requirements
>>>> 
>>>> On 19 June 2014 16:02, Tandy, Jeremy <jeremy.tandy@metoffice.gov.uk>
>>>> wrote:
>>>>> Hi Ivan -
>>>>> 
>>>>> I've created the new ucr WD on a new branch: pwd-ucr ... because I
>>>> didn't want to confuse things by publishing early wrt the W3C
>>>> publishing regime.
>>>>> 
>>>>> I've got up to step 4.vii of the [publishing process][1] but
>> because
>>>> I am not on gh-pages branch I can't push my new Overview.html to a
>>>> publically accessible web server in order to run the W3C pub rules
>>>> checker.
>>>> 
>>>> There's a service at rawgit.com that seems useful, for short-term
>> low
>>>> traffic use. I pasted https://github.com/w3c/csvw/blob/gh-pages/use-
>>>> cases-and-requirements/index.html
>>>> into their "development" form and get:
>>>> 
>>>> https://rawgit.com/w3c/csvw/gh-pages/use-cases-and-
>>>> requirements/index.html
>>>> 
>>>> I tried that in pubrules checker http://www.w3.org/2005/07/pubrules
>>>> and
>>>> got:
>>>> 
>>>> Using org.apache.xerces.parsers.SAXParser
>>>> Exception net.sf.saxon.trans.XPathException:
>>>> org.xml.sax.SAXParseException; systemId:
>>>> 
>> http://services.w3.org/tidy/tidy?docAddr=https%3A%2F%2Frawgit.com%2Fw
>>>> 3c %2Fcsvw%2Fgh-pages%2Fuse-cases-and-requirements%2Findex.html;
>>>> lineNumber: 11; columnNumber: 149; An invalid XML character
>> (Unicode:
>>>> 0x1b) was found in the element content of the document.
>>>> org.xml.sax.SAXParseException; systemId:
>>>> 
>> http://services.w3.org/tidy/tidy?docAddr=https%3A%2F%2Frawgit.com%2Fw
>>>> 3c %2Fcsvw%2Fgh-pages%2Fuse-cases-and-requirements%2Findex.html;
>>>> lineNumber: 11; columnNumber: 149; An invalid XML character
>> (Unicode:
>>>> 0x1b) was found in the element content of the document.
>>>> 
>>>> 
>>>> 
>>>> 
>>>>> Would you just recommend that I merge in the changes with gh-pages
>>>> branch and get on with the process?
>>>>> 
>>>>> Many thanks, Jeremy
>>>>> 
>>>>> [1]: https://github.com/w3c/csvw/blob/gh-
>> pages/publishing_process.md
>>>>> 
>>>>>> -----Original Message-----
>>>>>> From: Ivan Herman [mailto:ivan@w3.org]
>>>>>> Sent: 19 June 2014 11:37
>>>>>> To: Tandy, Jeremy; Jeni Tennison
>>>>>> Cc: Eric Stephan; Davide Ceolin; W3C CSV on the Web Working Group;
>>>>>> Dan Brickley
>>>>>> Subject: Re: June 18 call summary: resolved to publish use-cases-
>>>> and-
>>>>>> requirements
>>>>>> 
>>>>>> 
>>>>>> On 19 Jun 2014, at 10:23 , Tandy, Jeremy
>>>>>> <jeremy.tandy@metoffice.gov.uk> wrote:
>>>>>> 
>>>>>>> Ivan: """Tuesday 1st of July is our best option"""
>>>>>>> 
>>>>>>> I'm happy with this for next PWD release.
>>>>>> 
>>>>>> Would this be also a date for publishing the two other (model,
>>>>>> metadata) documents, or do we want to do an independent
>> publishing?
>>>>>> (Both are fine with me, but we should decide).
>>>>>> 
>>>>>> Jeremy, can you try to go through the publishing process, as
>>>>>> described in the archive? I hope that would work...
>>>>>> 
>>>>>> Ivan
>>>>>> 
>>>>>>> 
>>>>>>> Jeremy
>>>>>>> 
>>>>>>>> -----Original Message-----
>>>>>>>> From: Ivan Herman [mailto:ivan@w3.org]
>>>>>>>> Sent: 18 June 2014 17:13
>>>>>>>> To: Eric Stephan; Davide Ceolin; Tandy, Jeremy
>>>>>>>> Cc: W3C CSV on the Web Working Group; Dan Brickley
>>>>>>>> Subject: Re: June 18 call summary: resolved to publish use-
>> cases-
>>>>>> and-
>>>>>>>> requirements
>>>>>>>> 
>>>>>>>> 
>>>>>>>> On 18 Jun 2014, at 15:33 , Dan Brickley <danbri@google.com>
>>>> wrote:
>>>>>>>> 
>>>>>>>> <skip/>
>>>>>>>>> 
>>>>>>>>> Next steps: UCR editors, can you wrap up any outstanding
>> tweaks,
>>>>>> and
>>>>>>>>> liaise with Ivan to get a publication date scheduled? (please
>>>>>>>>> copy
>>>>>>>> the
>>>>>>>>> list on these details)
>>>>>>>> 
>>>>>>>> Publishing happens on tuesdays and thursdays. It always require
>>>>>>>> some preparation and also an agreement with the webmaster (to
>> put
>>>>>>>> this into his schedule). Note also what I wrote down after the
>>>>>>>> previous
>>>>>> round:
>>>>>>>> 
>>>>>>>> https://github.com/w3c/csvw/blob/gh-pages/publishing_process.md
>>>>>>>> 
>>>>>>>> which helps in speeding things up.
>>>>>>>> 
>>>>>>>> As far as my schedule is concerned, I am free next week Tuesday
>>>>>>>> (24th), but I am not really available for the rest of this week
>>>> (I
>>>>>> am
>>>>>>>> currently in Oslo for a conference, traveling back on Friday),
>> so
>>>>>>>> this may be tight. I am not available on the 26th. I am
>> available
>>>>>>>> on the first two weeks of July both on Tuesdays and Thursdays.
>>>>>>>> 
>>>>>>>> My feeling is that the Tuesday 1st of July is our best option,
>> at
>>>>>>>> least from my side (ie, if you can finalize the documents by
>>>> then)
>>>>>>>> 
>>>>>>>> Would that work?
>>>>>>>> 
>>>>>>>> Would we also want to schedule the two other documents for that
>>>>>>>> date (model and metadata)? Note that we need an explicit WG
>>>>>>>> resolution
>>>>>> and
>>>>>>>> a request for an official 'short name' for the latter, because
>>>>>>>> that is a first public draft. (In case you wonder: all this
>> admin
>>>>>>>> around the first draft is mainly necessary for the management of
>>>>>>>> Patent
>>>>>> Policies.
>>>>>>>> The world would be simpler if we did not have to deal with
>>>>>>>> that...)
>>>>>>>> 
>>>>>>>> Cheers
>>>>>>>> 
>>>>>>>> Ivan
>>>>>>>> 
>>>>>>>> 
>>>>>>>>> 
>>>>>>>>> chairs,
>>>>>>>>> 
>>>>>>>>> Dan
>>>>>>>>> 
>>>>>>>> 
>>>>>>>> 
>>>>>>>> ----
>>>>>>>> Ivan Herman, W3C
>>>>>>>> Digital Publishing Activity Lead
>>>>>>>> Home: http://www.w3.org/People/Ivan/
>>>>>>>> mobile: +31-641044153
>>>>>>>> GPG: 0x343F1A3D
>>>>>>>> WebID: http://www.ivan-herman.net/foaf#me
>>>>>>>> 
>>>>>>>> 
>>>>>>>> 
>>>>>>>> 
>>>>>>> 
>>>>>> 
>>>>>> 
>>>>>> ----
>>>>>> Ivan Herman, W3C
>>>>>> Digital Publishing Activity Lead
>>>>>> Home: http://www.w3.org/People/Ivan/
>>>>>> mobile: +31-641044153
>>>>>> GPG: 0x343F1A3D
>>>>>> WebID: http://www.ivan-herman.net/foaf#me
>>>>>> 
>>>>>> 
>>>>>> 
>>>>>> 
>>>>> 
>> 
>> 
>> ----
>> Ivan Herman, W3C
>> Digital Publishing Activity Lead
>> Home: http://www.w3.org/People/Ivan/
>> mobile: +31-641044153
>> GPG: 0x343F1A3D
>> WebID: http://www.ivan-herman.net/foaf#me
>> 
>> 
>> 
>> 
> 


----
Ivan Herman, W3C 
Digital Publishing Activity Lead
Home: http://www.w3.org/People/Ivan/
mobile: +31-641044153
GPG: 0x343F1A3D
WebID: http://www.ivan-herman.net/foaf#me