virtio — archive
[Date Prev]
| [Thread Prev]
| [Thread Next]
| [Date Next]
— [Date Index]
| [Thread Index]
| [Month Index]
| [List Home]
We need fixes to the csd and csprd before we can load them
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 <[email protected]> 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
[Date Prev]
| [Thread Prev]
| [Thread Next]
| [Date Next]
— [Date Index]
| [Thread Index]
| [Month Index]
| [List Home]