On Mon, Mar 24, 2014 at 12:15:16PM +1030, Rusty Russell wrote:
> Hi, >
>
My wife went into labor on Friday morning, so things are a bit
> hectic here. Michael, can you please organise this? Sure, I was doing it anyway.
> We had voted to make the TeX source authoritative for this version, BTW. >
> Thanks,
> Rusty. Yes, so I'll do that. > "Michael S. Tsirkin" <> writes: >
> On Thu, Mar 20, 2014 at 01:15:13PM -0400, Chet Ensign wrote: > >> Members of the VIRTIO TC, > >> > >> We are working on your Committee Spec Draft and public review for the 2nd csprd > >> for VIRTIO ( https://tools.oasis-open.org/issues/browse/TCADMIN-1638 and / > >> tools.oasis-open.org/issues/browse/TCADMIN-1641). > >> > >> In working on these, we have encountered some items that need to be fixed. As > >> you produce the documents, we ask that you make these and send us an updated > >> set of zip files. Here is what we need: > >> > >> 1) cover page changes needed for csd02 > >> > >> - This version: > >> > >> -- both tex and pdf are listed as authoritative. obviously 2 versions can’t be > >> authoritative. since pdf has been authoritative before, it seems best to stay > >> with that but regardless, please indicate one authoritative source (Latest, > >> Previous, This) > >> > >> -- assuming PDF is labelled authoritative, remove /tex directory. It is > >> indicated in the Additional artifacts section below > >> > >> - Previous version: > >>
--
Change links to > >> http://docs.oasis-open.org/virtio/virtio/v1.0/csprd01/virtio-v1.0-csprd01.pdf > >> http://docs.oasis-open.org/virtio/virtio/v1.0/csprd01/virtio-v1.0-csprd01.html > >> > >>
--
Label the PDF version (Authoritative) > >> > >> - Latest version: > >>
--
Label the PDF version (Authoritative) > >> > >> - Editors: > >>
--
Pawel’s link under ARM goes to a download page not to the company page. > >> Should be changed to http://www.arm.com
> >> > >> - Citation format: > >> We updated our citation model a few months ago to include the editors and the > >> Latest version link. Please update the citation block to read: > >> > >> [VIRTIO-v1.0] > >> > >> <italics>Virtual I/O Device (VIRTIO)
Version 1.0</>. Edited by Michael S. > >> Tsirkin, Cornelia Huck, and Pawel Moll. 11 March 2014. OASIS Committee > >> Specification Draft 02. http://docs.oasis-open.org/virtio/virtio/v1.0/csd02/ > >> virtio-v1.0-csd02.html. Latest version: http://docs.oasis-open.org/virtio/ > >> virtio/v1.0/virtio-v1.0.html. > >> > >> *Note that “OASIS” is also added before “Committee Specification Draft 02” for > >> the csd and before "Committee Specification Draft 02 / Public Review Draft 02" > >> for the csprd. > >> > >> - Notices: > >> Set copyright year to 2014 > >> > >> - In PDF, for footer: > >> Set copyright year to 2014. > >> > >> 2) cover page changes needed for csprd02: > >> > >> - Same changes as for the csd02 files. > >> > >>
--
Plus: The ZIP file contains all the individual html files for the footnotes, > >> but they are not needed. They should be removed. I think the TC removed them > >> in the csd02 files, but not in the csprd02 files. (csprd02 footnotes work fine > >> without the files - the footnotes are embedded and linked in the main .html > >> file.) > >> > >>
--
We need a red-lined DIFF file in PDF between csprd02 and csprd01 that > >> displays the changes. We point out this to reviewers in order to limit the > >> public review comments to only those that changed. > > >
> Due to the huge number of formatting and text movement changes, we ended >
> up with almost all of the file red-lined. On the TC, we voted to >
> produce csprd02 and csd02 without this DIFF and start producing DIFF >
> files from version 03. > > >
> I hope this is acceptable. > > > >> 3) We need a comment resolution log from the TC for comments received in > >> csprd01 > > >
> I actually wrote a script to append the resolution changelog as last >
> part of the file, but this was done after csd02/csprd02 were approved. >
> Do you think appending the log is an acceptable change to make >
> without re-doing the voting? > > > >> Thanks - if you can send me those files when they are ready, I'll update the > >> ticket and we will continue to process the spec. > >> > >> Thanks & best, > >> > >> /chet > > >
> I'll work on this shortly - unless Rusty already started? > > > > > >> > >> > >> -- > >> > >> /chet > >>
----------------
> >> Chet Ensign > >> Director of Standards Development and TC Administration > >> OASIS: Advancing open standards for the information society > >> http://www.oasis-open.org > >> > >> Primary: +1 973-996-2298 > >>
Mobile: +1 201-341-1393 > >> > >> Check your work using the Support Request Submission Checklist at http:// > >> www.oasis-open.org/committees/download.php/47248/ > >> tc-admin-submission-checklist.html > >> > >> TC Administration information and support is available at http:// > >> www.oasis-open.org/resources/tcadmin > >> > >> Follow OASIS on: > >> LinkedIn:
http://linkd.in/OASISopen > >> Twitter:
http://twitter.com/OASISopen > >> Facebook:
http://facebook.com/oasis.open
