On Mon, Mar 24, 2014 at 02:26:07PM -0400, Chet Ensign wrote:
> Hi Michael -
>
> > 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.
>
> Hmm. Well, it means that the entire spec will be once again open for comments.
> Since there is no way to direct people to what has changed, they'll be able to
> comment on everything.
>
> Also, with so many changes, you might want to consider extending the review
> beyond 15 days.
For now the TC voted on a 15 day review.
I hope we can proceed with publication, and we can vote on
extending the review period later - either with an
online ballot or at the next meeting April 8.
> >> 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?
>
> This isn't the change log on the specification, this is a comment tracking and
> resolution log reporting the comments received and the TC's decisions on them
> as explained in https://www.oasis-open.org/resources/tcadmin/
> handling-the-comments-received-during-a-public-review
>
> That has specific information requirements and must be a stand-alone document
> so that I can store it along with the public review copy.
>
> Best,
>
> /chet
>
>
>
> On Sun, Mar 23, 2014 at 12:36 PM, Michael S. Tsirkin <mst@redhat.com> wrote:
>
> 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
|