Publish OSLC Quality Management 2.1 PSD 02

[berezovskyi]

Requester name:
Andrew Berezovskyi

OP name:
OASIS Open Services for Lifecycle Collaboration (OSLC) OP

OP email address:
oslc-op@lists.oasis-open-projects.org

Title:
OSLC Quality Management 2.1 PSD 02

Request link:
https://github.com/oslc-op/oslc-specs/releases ("Assets" under Quality Management 2.1 PSD 02)

Notes:

• PGB vote will remain open till 2019-11-14 but already got the majority of votes.
• OP issue
• PSD PR

[OASIS-OP-Admin]

Assigning this ticket to Paul for next steps.

[berezovskyi]

@paul-knight the PGB ballot has passed.

[berezovskyi]

@paul-knight did you have a chance to look into publishing the spec?

[paul-knight]

This is next up in the queue.

[berezovskyi]

Thanks, Paul! Cheers, Andrew

…

________________________________ From: Paul Knight <notifications@github.com> Sent: Thursday, November 21, 2019 5:30 PM To: oasis-open-projects/administration Cc: Andrew Berezovskyi; Author Subject: Re: [oasis-open-projects/administration] Publish OSLC Quality Management 2.1 PSD 02 (#8) This is next up in the queue. — You are receiving this because you authored the thread. Reply to this email directly, view it on GitHub<#8?email_source=notifications&email_token=AAAPZXQF4DZT45YMIFCT35LQU2ZQXA5CNFSM4JK6GZ62YY3PNVWWK3TUL52HS4DFVREXG43VMVBW63LNMVXHJKTDN5WW2ZLOORPWSZGOEE22OSQ#issuecomment-557164362>, or unsubscribe<https://github.com/notifications/unsubscribe-auth/AAAPZXS7VVCF3DIZTAIPVRTQU2ZQXANCNFSM4JK6GZ6Q>.

[paul-knight]

Downloaded https://github.com/oslc-op/oslc-specs/releases/download/untagged-f22298f9af3109436b49/qm-2.1-psd02_20191107.zip as the source material.

ZIP file contents:
quality-management-spec.html
quality-management-vocab.html
quality-management-vocab.ttl
oslc_qm_resources.png

Approval date is 14 November 2019, based on closing date of PGB approval.

[paul-knight]

This looks pretty good. I noted a few elements:

• the .ttl file should be listed with the "Additional artifacts" if it is considered a normative part of the specification.
• I don't really like the way "Previous stage" links are handled, since they point to off-site "fake" versions of documents which were never published, with false/broken front page URIs and today's date. I'll ask for Chet's opinion on permitting this, during the staging review
• The <hr> element occurs twice following the TOC in Part 1, so there are two lines in the HTML, and a blank page in the PDF. I have not adjusted that, to keep consistency with the OP's source material.
• I'm not sure why the PDF font size is smaller in Part 2. I think it might be due to the need to squeeze in the fairly wide tables in Section 3. This could probably be prepared in landscape mode if desired.

This looks about ready for staging.

[paul-knight]

Prepared and installed files.
Requested OASIS staff staging review: (also attaching the ZIP to this ticket since staging server is not public)

Please review the staging server installation of the files for OSLC Quality Management 2.1 PSD02.

This has one or two elements of concern:

• The "Previous stage" links point to off-site "fake" versions of documents which were never published, with false/broken front page URIs and today's date (i.e., I think it just lists today's date, whatever it is - currently 27 November 2019). I think this should be "N/A", but I can let it pass if you are okay with it...
• The .ttl file is not listed or referenced anywhere, as far as I could see. For the future, I think it should be in Additional artifacts, if it is a normative artifact.
• The PDFs have some issues - a blank page in Part 1 after the TOC (due to two <hr> tags in the HTML), and very small font in Part 2, probably due to the squeezing in the tables in Part 3. This could be rendered in landscape to allow a larger font, I think (I didn't try that yet).

The files are:

OSLC Quality Management Version 2.1
Project Specification Draft 02
14 November 2019

OSLC Quality Management Version 2.1. Part 1: Specification
https://docs-staging.oasis-open-projects.org/ztest/oslc-op/qm/v2.1/psd02/quality-management-spec.html
https://docs-staging.oasis-open-projects.org/ztest/oslc-op/qm/v2.1/psd02/quality-management-spec.pdf
OSLC Quality Management Version 2.1. Part 2: Vocabulary
https://docs-staging.oasis-open-projects.org/ztest/oslc-op/qm/v2.1/psd02/quality-management-vocab.html
https://docs-staging.oasis-open-projects.org/ztest/oslc-op/qm/v2.1/psd02/quality-management-vocab.pdf
Turtle file:
https://docs-staging.oasis-open-projects.org/ztest/oslc-op/qm/v2.1/psd02/quality-management-vocab.ttl

Please add comments to #8.
qm-v2.1-psd02.zip

[berezovskyi]

The "Previous stage" links point to off-site "fake" versions of documents which were never published, with false/broken front page URIs and today's date (i.e., I think it just lists today's date, whatever it is - currently 27 November 2019). I think this should be "N/A", but I can let it pass if you are okay with it...

We tried to link somehow to the work done before the OP transition. Unfortunately, we discovered that indeed no CSPRD was ever published and pointed to the latest snapshot. Next PSD will refer to this document.

The .ttl file is not listed or referenced anywhere, as far as I could see. For the future, I think it should be in Additional artifacts, if it is a normative artifact.

will fix in the next PSD

The PDFs have some issues - a blank page in Part 1 after the TOC (due to two

---

tags in the HTML),

will fix in the next PSD

and very small font in Part 2, probably due to the squeezing in the tables in Part 3. This could be rendered in landscape to allow a larger font, I think (I didn't try that yet).

have no idea what to do with it 🤷‍♂

cc @jamsden

[OASIS-OP-Admin]

I looked over the files.

• on the Previous stage links, it should either point to the pre-OASIS draft that was on the OSLC site or it should be N/A. The current document looks like an approved OASIS public review draft (which as we know never actually happened) and gives a non-existent location on docs.oasis-open.org. We shouldn't imply a formal history that ever actually happened.

• the Latest version draft link doesn't work for me (but maybe it will after being installed?)

• In Status, looking at “Comments on this work can be provided by opening issues in the project repository or by sending email to the project’s public comment list oslc-op@lists.oasis-open-projects.org." (a) I suggest we add a link to the URL for the repository so it isn't clear from anything the front page where that is, and (b) oslc-op@ is meant to be a general purpose list. Perhaps I should create an oslc-op-comment@ list specifically for comments? What do you think?

• At the bottom of 1.4 Typographical Conventions… There is the word "Conventions" that looks like it is a level 1 heading but there is nothing below it. Error?

• The tables in teh PDF of Part 2 look ok on my screen. Switching the pages to landscape would give the columns more breathing room but that may be difficult to do technically.

That is my comments.