Re: [virtio] We need fixes to the csd and csprd before we can load them

["Michael S. Tsirkin" <mst@redhat.com>]

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" <mst@redhat.com> 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