Re: Editorial comments on VIRTIO v1.2 csd01

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

On Tue, May 10, 2022 at 12:05:11PM -0400, Paul Knight wrote:
> Hi all,
> 
> (Using correct email for Cornelia this time - apologies!)
> 
> Thanks for addressing the list of editorial issues. Since we have already
> published the current documents and announced the public review, we will not
> change them. Now that you have fixed your source files, they will be correct
> in your repository for your future publications.
> 
> Regarding the reference to [S390 Common I/O] , our key requirement is to avoid
> publishing "OASIS Standards Final Deliverables [1]" documents with broken
> hyperlinks, particularly for a Normative reference. If the document is not
> available online, you can simply provide the title, publisher, date, etc.,
> similar to a printed book, with no hyperlink.
> 
> Best regards,
> Paul


Thanks! I would very appreciate if you checked out especially the css
issue in the new revision to make sure it looks good now.

> [1] https://www.oasis-open.org/policies-guidelines/
> oasis-defined-terms-2018-05-22/#dOASISstdsFinal
> 
> On Tue, May 10, 2022 at 10:59 AM Michael S. Tsirkin <mst@redhat.com> wrote:
> 
>     On Mon, May 09, 2022 at 04:40:53PM -0400, Paul Knight wrote:
>     > Hi all,
>     >
>     > These comments are intended for the TC Editors, although I'm sending it
>     to the
>     > TC's email list for future reference.
>     >
>     > In running a link check, I noted several issues, none significant for
>     this
>     > initial public review publication:
>     > - broken link in Normative references:
>     > -- [S390 Common I/O] ESA/390 Common I/O-Device and Self-Description, IBM
>     > Publication SA22-7204,
>     > http://publibfp.dhe.ibm.com/cgi-bin/bookmgr/BOOKS/dz9ar501/CCONTENTS, and
>     any
>     > future revisions
>     > (This link is currently broken, and I could not find any alternative
>     source for
>     > this document. - please rewrite the reference to indicate document is no
>     longer
>     > available at this link. You may also consider whether the solitary
>     citation at
>     > 4.3.1.3 is still needed.)
>     > This broken link is not a blocking issue for a Committee specification
>     Draft,
>     > but it will not be allowed for a Committee Specification.
>     >
>     > Minor broken links in the "Revision History" - Appendix D
>     > - https://lists.oasis-open.org/archives/virtio-dev/201910/msg00057.html.
>     (bad
>     > link due to inclusion of the terminating period - second item dated 01
>     Sep 2020
>     > in Appendix D Revision history) - not a blocking issue
>     > -  https://lkml.org/lkml/2020/4/21/1020) (bad link due to including the
>     final
>     > right parenthesis in the hyperlink - item dated 01 Sep 2020 by Petre
>     Eftime) -
>     > not a blocking issue
>     > - https://github.org/oasis-tcs/virtio-spec/issues/97  (bad link due to
>     using
>     > github.org instead of github.com - first item dated 30 Mar 2021 in
>     Appendix D
>     > Revision history) - not a blocking issue
>     >
>     > Appearance:
>     > - (HTML only) To conform to OASIS style, this should use bold font in
>     title and
>     > headings from top through "Notices"
>     > -- I noted that in the HTML file, these headings use class="aeb10-", but
>     this
>     > is not defined in the .css file.
>     > -- For this publication, I defined it by inserting the line below into
>     the .css
>     > file (virtio-v1.2-csd01.css, at line 18), which fixed this issue:
>     > --- .aeb10-{font-weight: bold;}
>     > Please make this adjustment (or something with a similar effect) in your
>     > publication process for the future.
>     >
>     > Best regards,
>     > Paul
> 
> 
>     Hi Paul,
>     Just in case you think it's appropriate, I uploaded a version with these
>     changes as a revision for csd01.
> 
>     Here it is, revision 3:
>     https://www.oasis-open.org/apps/org/workgroup/virtio/download.php/69907/
>     virtio-v1.2-wd02-as-csd01-diffs.zip
> 
> 
>     > --
>     > Paul Knight....Document Process Analyst
>     > OASIS...Setting the standard for open collaboration
> 
> 
> 
> 
> --
> Paul Knight....Document Process Analyst
> OASIS...Setting the standard for open collaboration