SMV for OSLC CM v3.0 PS01

berezovskyi commented 4 years ago

Requester name: Andrew Berezovskyi

OP name: OSLC OP

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

Title: OSLC Change Management v3.0 Project Specification 01

Approval link: https://lists.oasis-open-projects.org/g/oslc-op/topic/oslc_change_management_v3_0/76458160?p=,,,50,0,0,0::recentpostdate%2Fsticky,,,50,2,0,76458160

Notes: Requesting to open a ballot on September 10

chet-ensign commented 4 years ago

Acknowledged. Ballot steps has been added to my calendar.

berezovskyi commented 4 years ago

@OASIS-OP-Admin is it possible to do pre-publication review for the package in parallel, please? We have not received any critical feedback so far.

OASIS-OP-Admin commented 4 years ago

The Special Majority Vote is set up. See https://lists.oasis-open-projects.org/g/oslc-op-pgb/topic/vote_on_oslc_core_v3_0_1/76734933?p=,,,20,0,0,0::recentpostdate%2Fsticky,,,20,2,0,76734933

Poll closes on Sept. 16 at which point we will announce the results and proceed with the next steps.

berezovskyi commented 4 years ago

Just a reminder to close the poll. Thank you!

chet-ensign commented 4 years ago

Thanks Andrew!

On Thu, Sep 17, 2020 at 9:48 AM Andrew Berezovskyi notifications@github.com wrote:

Just a reminder to close the poll. Thank you!

— You are receiving this because you were assigned. Reply to this email directly, view it on GitHub https://github.com/oasis-open-projects/administration/issues/13#issuecomment-694247424, or unsubscribe https://github.com/notifications/unsubscribe-auth/ACYUWRMRWMUL5PAXTJ6ZPHDSGIHSXANCNFSM4QNJKDJA .

--

/chet

Chet Ensign Chief Technical Community Steward OASIS: Advancing open source & open standards for the information society http://www.oasis-open.org

Mobile: +1 201-341-1393

OASIS-OP-Admin commented 4 years ago

The ballot closed and passed. OSLC Change Management received 3 yes votes, no no votes, and 1 abstentions. The result was announced to the PGB and the project mailing list. See https://lists.oasis-open-projects.org/g/oslc-op-pgb/topic/oslc_core_v3_0_and_change/76910221?p=,,,20,0,0,0::recentpostdate%2Fsticky,,,20,2,0,76910221

Staff will now publish the PS and notify the project when it is available.

OASIS-OP-Admin commented 4 years ago

TC Admin JIRA ticket https://issues.oasis-open.org/browse/TCADMIN-3807 has been opened to track this work.

paul-knight commented 4 years ago

Initial review of files in:

https://github.com/oslc-op/oslc-specs/releases/download/untagged-0c0acf3511fe0931ad07/cm-v3.0-ps01.zip

General - would prefer not to refer to the TTL files as "Parts", and it would be preferable to use a title which matches their internal documentation. For example, "The OSLC Change Management (CM) Vocabulary" rather than "Part 4: Machine Readable Vocabulary Terms". (Or possibly, modify the internal labels to reflect "Part 4" status...)

Part 1:

common issue with hyperlink of the "Latest stage" PDF - fixed
"Previous stage" URLs set to point to the PSD03 instead of older material under the TC - fixed
"Additional components" only lists Part 1 and Part 2 - fixed (copied from Part 2)
no other issues noted

Part 2:

same two issues as for Part 1. fixed.
no other issues noted

Part 3:

same issue with Latest stage PDF - fixed.
no other issues noted

TTL files:

copyright year should be bumped to 2020 instead of 2019.

Overall - looks good - ready for next steps in publication.

paul-knight commented 4 years ago

Generated PDF files using the "temporary-Library-Install" process, so relative links in the PDF formats will be properly resolved. Removed the temporary installation. Set up installation scripts - looks ready for staging operations.

paul-knight commented 4 years ago

Prepared and installed files into staging server.

added two new symlinks for the new Part 3.
updated 4 old symlinks
set timestamps
inspected and tested installation

Requested staging review by OASIS staff (also attaching a ZIP with the files) cm-v3.0-ps01-staging.zip

Please review the OP staging server installation of the files for OSLC CM v3.0 PS01.

This has three Parts, plus two TTL files I only noted one minor remaining issue - The copyright year listed inside the TTL files should be bumped to 2020 instead of 2019. Although the front-page URI for "Additional components" are already FQDN (not relative), there are relative links within the text, so I still had to use the "temporary install" process to generate the PDFs.

The files are:

OSLC Change Management Version 3.0 Project Specification 01 17 September 2020

Please add comments to https://github.com/oasis-open-projects/administration/issues/13. Also tracked in https://issues.oasis-open.org/browse/TCADMIN-3807.

OASIS-OP-Admin commented 4 years ago

I looked over the files. All seems ship-shape and in order. I approve to promote to docs.oasis-open-projects.org

paul-knight commented 4 years ago

To be promoted to docs.oasis-open-projects.org along with other current OSLC OP documents...

Query - probably staged late today
Architecture Management - Real Soon Now

paul-knight commented 4 years ago

I found some significant issues in the PDF files which (I think) can be fixed by manually editing each PDF (14 of them across the four PS01s) and re-installing. However, I'll go ahead and ask for a sanity check on the documents, so if anything else shows up, I can also address that, while fixing the PDFs.

Essentially, the WKHTMLTOPDF process does not handle a self-referential link in the base HTML the way we want it to. It changes the self-referential link in the HTML to a self-referential link within the PDF. This means that it turns the "This stage/version" link for HTML into a link for the PDF (and also any other self-referential links, like the citation format).

Otherwise, I think these are ready to release - so here is the request for a sanity check, while I get the 14 files patched up... The files are:

OSLC Change Management Version 3.0 Project Specification 01 17 September 2020

OASIS-OP-Admin commented 4 years ago

Copyright dates on ttl files is 2019. Otherwise, everything looks good. With fixes, I approve to release.

paul-knight commented 4 years ago

Had to replace PDF files (bad self-reference links). Files repackaged, with ZIP and manifest files, dates set, etc. Removed README warning file. Should be ready for release along with other three (AM will be handled separately later - waiting for updated files).

paul-knight commented 4 years ago

@chet-ensign Chet will coordinate announcements of the four Project Specifications (Core, CM, RM, Query)

Note the publication URIs are listed in an earlier comment.

OASIS-OP-Admin commented 4 years ago

I have announced the publication of the Prj Specs - OASIS homepage (https://www.oasis-open.org/news/announcements/four-new-project-specifications-approved-by-the-oslc-open-project), Twitter, LinkedIn groups, emails (https://lists.oasis-open-projects.org/g/oslc-op/topic/four_new_project/77486324?p=,,,20,0,0,0::recentpostdate%2Fsticky,,,20,2,0,77486324). I also added them to the OASIS Standards page under the Committee/Project Specifications grouping (https://www.oasis-open.org/standards#oslc-cm-v3.0-ps01). I'm checking with Andrew about adding this as a news article to open-services.net.

No further tasks to do so I'm closing this ticket.

oasis-open-projects / administration

SMV for OSLC CM v3.0 PS01 #13

/chet