List Home Dates Threads Authors Subjects
virtio - Re: [virtio] We need fixes to the csd and csprd before we can load them Message Thread: Previous | Next
  • From: "Michael S. Tsirkin" <mst@redhat.com>
  • To: Chet Ensign <chet.ensign@oasis-open.org>
  • Date: Mon, 24 Mar 2014 23:13:06 +0200
On Mon, Mar 24, 2014 at 02:29:03PM -0400, Chet Ensign wrote:
> First of all, best wishes to you and your family. I still recall the excitement
> when my daughter was born! 
> 
> We noted that the TeX was voted as authoritative. If that is the case then
> you'll need to add the TeX directory to the This version and Latest version
> links and - is there a master driver file from which all the others are
> processed or assembled? I never did work with TeX but assuming there is, that I
> suppose would be the file to point to. You'll also have to take the
> (Authoritative) designation off the PDF files. 

Hmm yes but the master file is mostly empty - it just has names
of included sub-files.
I think it's best to point at a zip archive with
all the necessary files.
Is that OK?

> 
> On Sun, Mar 23, 2014 at 9:45 PM, Rusty Russell <rusty@rustcorp.com.au> wrote:
> 
>     Hi,
> 
>             My wife went into labor on Friday morning, so things are a bit
>     hectic here.  Michael, can you please organise this?
> 
>     We had voted to make the TeX source authoritative for this version, BTW.
> 
>     Thanks,
>     Rusty.
> 
>     "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
> 
> 
> 
> 
> --
> 
> /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

By Date: Previous | Next Current Thread By Thread: Previous | Next