Re: UCR ED Draft - back to you Frans and Alejandro

On 10/12/2015 13:59, Frans Knibbe wrote:
> Hello Phil,
>
> I have done the spell check and managed to fix some errors. I have also
> added the change history appendix and added a link to that in the header,
> below *Changes:*.

Thank you!

>
> I noticed that some use cases have received some extra annotation, using
> the bibo ontology (wich appears to be offline), and using the 'xhv' prefix,
> which is not defined. It seems that the use cases with this extra
> annotation also have duplicate numbering in the TOC. Could it be that the
> annotation was copied from index.html and is not supposed to be in the
> editor's draft?

You are correct, I was a little sloppy in my copying this morning - I'll 
fix those errors now and get the doc installed in its final home.

Our webmaster is asking for as much advanced notice as possible for 
publications for next week, understandably, so I'd like to get 
everything sorted today.

Cheers

Phil.

>
> Regards,
> Frans
>
>
> 2015-12-10 12:30 GMT+01:00 Phil Archer <phila@w3.org>:
>
>>
>>
>> On 10/12/2015 11:06, Frans Knibbe wrote:
>>
>>> Hello Phil,
>>>
>>> I am currently working on a summary of main changes between the first and
>>> second working drafts. I thought calling it "Appendix A: History of
>>> changes" and putting it at the bottom of the document would be a good
>>> idea,
>>> with an added link to this new section in the document header (below the
>>> links *This version:* and *Latest published version:*).
>>>
>>> I guess the appropriate place to add the new section now is in
>>> SDWUseCasesAndRequirements.html
>>> <
>>> https://github.com/w3c/sdw/blob/gh-pages/UseCases/SDWUseCasesAndRequirements.html
>>>> ,
>>> not in index.html of the snapshot. Am I right?
>>>
>>
>> Yes, please work on the Ed's draft, not the snapshot. Not sure about
>> adding a link from the DL at the top of the page - up to you, but you'd
>> need to fiddle with the respec config object to do that (something I keep
>> messing up and spend half an hour debugging every time I change something!)
>>
>>
>>
>>
>>> And shall I save the HTMLDiff document to GitHub and add a reference to
>>> that too (like the CSV on the Web people have done)? If we do, the new
>>> history appendix should be in the derived index file before HTMLDiff is
>>> executed.
>>>
>>
>> I'll generate the diff doc, it's OK, thanks. I'll generate that once the
>> fully stable doc is installed in its eventual place, (Shhh... it's there
>> already at http://www.w3.org/TR/2015/NOTE-sdw-ucr-20151217/ but will need
>> updating as a result of our work today).
>>
>> One thing I haven't done yet that would be good, please, is to:
>> - run the text through a spell checker (if you haven't already)
>> - make sure that the word Web is capitalised throughout (that is, whenever
>> it's used to refer to the WWW).
>>
>> Phil.
>>
>>
>>
>>
>>> Regards,
>>> Frans
>>>
>>>
>>>
>>>
>>>
>>> 2015-12-10 11:46 GMT+01:00 Phil Archer <phila@w3.org>:
>>>
>>> Frans, Alejandro,
>>>>
>>>> Following last night's telco I have made some tweaks to the ED draft of
>>>> the UCR doc.
>>>>
>>>> 1. I've added in links to the GH repo and a link to a (so far
>>>> non-existent) diff document. I'll generate the latter when you're done.
>>>> This is my Action-123.
>>>>
>>>> 2. As you know, I also made some changes when generating the snapshot,
>>>> mostly removing or updating broken links and changing the scripting a
>>>> little so that all text is shown by default (it's hidden if scripting is
>>>> active). So I've put those changes back into the Ed draft so they're
>>>> closer
>>>> to being back in sync.
>>>>
>>>> What's left for you to do is to add a bit of editorial text highlighting
>>>> the main changes since the last version. See
>>>> http://www.w3.org/TR/tabular-data-model/#changes for an example of the
>>>> kind of thing Lord Tandy was pointing us to last night.
>>>>
>>>> As soon as that's done I can add it to the snapshot, after which Josh and
>>>> Scott can judge whether:
>>>>
>>>> - adding hyperlinks to the diff anad the GH repo;
>>>> - adding some text that points people to the main changes since the
>>>> previous version;
>>>> - *no* changes to the actual content of the document;
>>>>
>>>> means a new R number for OGC (let's hope not but it might). At this
>>>> stage,
>>>> the snapshot from which I generated the PDF that is in the OGC Pending
>>>> system is unchanged.
>>>>
>>>> Cheers
>>>>
>>>> Phil.
>>>>
>>>>
>>>> --
>>>>
>>>>
>>>> Phil Archer
>>>> W3C Data Activity Lead
>>>> http://www.w3.org/2013/data/
>>>>
>>>> http://philarcher.org
>>>> +44 (0)7887 767755
>>>> @philarcher1
>>>>
>>>>
>>>
>> --
>>
>>
>> Phil Archer
>> W3C Data Activity Lead
>> http://www.w3.org/2013/data/
>>
>> http://philarcher.org
>> +44 (0)7887 767755
>> @philarcher1
>>
>

-- 


Phil Archer
W3C Data Activity Lead
http://www.w3.org/2013/data/

http://philarcher.org
+44 (0)7887 767755
@philarcher1

Received on Thursday, 10 December 2015 14:21:20 UTC