Re: Minor tweaks to DUV doc

Hi Phil,

Thanks a lot for helping us to improve the doc and to fix those problems!
An existing doc was used as a start point for our doc and I think that this
one of the reasons for some of the problems that you pointed out.

We are still working on the document and some of the open issues will be
removed. We are also updating the model and the examples. When we finish,
we're gonna update Appendix B.

Cheers,
Berna

2015-12-10 9:38 GMT-03:00 Phil Archer <phila@w3.org>:

> Eric, Sumit, Berna,
>
> I've been looking at the DUV doc today and seeing where I might be able to
> help. First thing I noticed was that ReSpec wasn't doing its job properly
> and was reporting some odd errors. I wanted to blame my colleague Eric
> Prud'hommeaux for that but that wouldn't be entirely fair. I think his
> script for the T/J switch was included twice, once externally and once
> within the doc. That upset things so that reSpec couldn't work but - it's
> OK now, so that references work (e.g. [[VOCAB-DCAT]].
>
> Remember that it's easy to include references. Most of what you'll ever
> want to include a ref to is included by ReSpec. You can look up what is in
> its library at http://www.specref.org/
>
> There was some text written into the HTML that I guess came from previous
> versions where ReSpec generates it (the doc status boiler plate stuff, the
> references etc.). I think that's all fixed now too.
>
> The doc has many open issues and notes - which is fine - but are they all
> still relevant?
>
> I'll generate the diff from the previous version before publication but if
> you could please add a little bit of editorial text to Appendix B (Change
> history) that would be good - i.e. give people a quick view of what has
> changed since http://www.w3.org/TR/2015/WD-vocab-duv-20150625/
>
> HTH
>
> Phil.
>
>
> --
>
>
> Phil Archer
> W3C Data Activity Lead
> http://www.w3.org/2013/data/
>
> http://philarcher.org
> +44 (0)7887 767755
> @philarcher1
>



-- 
Bernadette Farias Lóscio
Centro de Informática
Universidade Federal de Pernambuco - UFPE, Brazil
----------------------------------------------------------------------------

Received on Thursday, 10 December 2015 13:13:34 UTC