virtio — archive

[Michael S. Tsirkin]

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