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

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

Received on Thursday, 10 December 2015 11:31:03 UTC