-
Type:
Task
-
Status: Closed
-
Priority:
Major
-
Resolution: Fixed
-
Component/s: Document Upload Request
-
Labels:None
-
Environment:
OSLC
Your name:
Andrii Berezovskyi
Project name:
OSLC Open Project
Project email address:
[1]oslc-op@lists.oasis-open-projects.org
Title and version number:
OSLC Tracked Resource Set Guidance 1.0
Approval:
[2]https://lists.oasis-open-projects.org/g/oslc-op-pgb/message/210
Notes:
We forgot to add number to the title of the draft.
----------------------------------------------------------------------------------------
[1] oslc-op@lists.oasis-open-projects.org
[2] https://lists.oasis-open-projects.org/g/oslc-op-pgb/message/210
List of expected changes (Word document) has been attached to https://issues.oasis-open.org/browse/TCADMIN-4132.
Link to Word document:
Paul, please find the updated document attached.
URI is wrong. It is the same as for "link-guidance".
There are five similar Project Notes being published, with modifications required for each.
As of 17 February, the OSLC OP team is focusing on "Summary of changes in OSLC Core 3.0", TCADMIN-4135. (see note there)
Once that PN is published, will replicate the outstanding changes to the rest of the PNs and check the document with the feedback again.
I will set this issue to "Stop Progress" until the updates are ready.
Status update:
This is one of five OSLC OP Project Notes which are in development:
- Link Guidance - https://issues.oasis-open.org/browse/TCADMIN-4132
- Config Mgt. Primer - https://issues.oasis-open.org/browse/TCADMIN-4134
- Summary of changes in OSLC Core v3.0 - https://issues.oasis-open.org/browse/TCADMIN-4135
- Tracked Resource Set Guidance - https://issues.oasis-open.org/browse/TCADMIN-4136
- Tracked Resource Set Primer - https://issues.oasis-open.org/browse/TCADMIN-4137
The OSLC OP has prepared an updated draft which appears to meet the requirements for publication. (see TCADMIN-4135)
I provided a few comments, primarily on updating some boilerplate links to OASIS resources, which will apply to all publications.
See these comments at https://issues.oasis-open.org/browse/TCADMIN-4135?focusedCommentId=81121&page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel#comment-81121
The OSLC OP Editors will prepare an updated draft for this Project Note.
Paul, please find the updated PN in trs-guidance.html_2022-05-18.zip
Downloaded updated PN: https://issues.oasis-open.org/secure/attachment/11942/trs-guidance.html_2022-05-18.zip
Initial inspection:
- no significant issues noted.
Later - noted there is no "description" tag - will add based on Abstract.
Added "description" tag to HTML.
Generated PDF.
Installed files for staging review:
- prepared files with timestamps, ZIP, and manifest in personal directory
- staging directory already in place in /ztest for other concurrent OSLC OP docs
- created new WP, Version and stage directories
- copied files into stage directory
- added new symlinks
- installed README warning file
- set timestamps for directory and symlinks, also for version directory.
- checked installation - looks okay
- will request OASIS staff staging review along with other remaining PNs
Requested OASIS staff staging review for four PNs:
Please review the staging server installation of the remaining four Project Notes from the OSLC OP.
These are all fairly short.
The files are:
OSLC Core Version 3.0: Link Guidance Version 1.0
Project Note 01
16 December 2021
https://docs-staging.oasis-open-projects.org/ztest/oslc-op/link-guidance/v1.0/pn01/link-guidance.html
https://docs-staging.oasis-open-projects.org/ztest/oslc-op/link-guidance/v1.0/pn01/link-guidance.pdf
-
-
- Please add comments to https://issues.oasis-open.org/browse/TCADMIN-4132.
-
***************************************************
Configuration Management Primer Version 1.0
Project Note 01
16 December 2021
https://docs-staging.oasis-open-projects.org/ztest/oslc-op/config-primer/v1.0/pn01/config-primer.html
https://docs-staging.oasis-open-projects.org/ztest/oslc-op/config-primer/v1.0/pn01/config-primer.pdf
-
-
- Please add comments to https://issues.oasis-open.org/browse/TCADMIN-4134.
-
***************************************************
OSLC Tracked Resource Set Guidance Version 1.0
Project Note 01
16 December 2021
https://docs-staging.oasis-open-projects.org/ztest/oslc-op/trs-guidance/v1.0/pn01/trs-guidance.html
https://docs-staging.oasis-open-projects.org/ztest/oslc-op/trs-guidance/v1.0/pn01/trs-guidance.pdf
-
-
- Please add comments to https://issues.oasis-open.org/browse/TCADMIN-4136.
-
***************************************************
Tracked Resource Set Primer Version 1.0
Project Note 01
16 December 2021
https://docs-staging.oasis-open-projects.org/ztest/oslc-op/trs-primer/v1.0/pn01/trs-primer.html
https://docs-staging.oasis-open-projects.org/ztest/oslc-op/trs-primer/v1.0/pn01/trs-primer.pdf
-
-
- Please add comments to https://issues.oasis-open.org/browse/TCADMIN-4137.
-
Wow. I am surprised they want to go ahead and publish this given the disclaimer on the front page: "...not yet ready for publication.
Several current editors and project members feel many of the opinions expressed in the Guidance sections are excessively strict or judgemental, and not appropriate for general guidance."
It is their choice of course and, other than that, I think the files are fine to promote.
But wow...
Promoted approved files to OASIS Library (docs.oasis-open-projects.org) for final reviews
- Synced files from /ztest to canonical directory (/htdocs)
- Synced to OASIS OP Library (docs.oasis-open-projects.org)
- checked links, etc.
- no link issues found in any of the five PNs
- requested sanity check:
Please review the OASIS Library installation of the files for five OSLC PN01s.
I did not find any broken links or other issues.
Configuration Management Primer Version 1.0
Project Note 01
16 December 2021
https://docs.oasis-open-projects.org/oslc-op/config-primer/v1.0/pn01/config-primer.html
https://docs.oasis-open-projects.org/oslc-op/config-primer/v1.0/pn01/config-primer.pdf
-
-
- Please add comments to https://issues.oasis-open.org/browse/TCADMIN-4134.
***************************************
- Please add comments to https://issues.oasis-open.org/browse/TCADMIN-4134.
-
OSLC Core v3.0 Changes Version 1.0
Project Note 01
16 December 2021
https://docs.oasis-open-projects.org/oslc-op/core-3.0-changes/v1.0/pn01/core-3.0-changes.html
https://docs.oasis-open-projects.org/oslc-op/core-3.0-changes/v1.0/pn01/core-3.0-changes.pdf
-
-
- Please add comments to https://issues.oasis-open.org/browse/TCADMIN-4135.
***************************************
- Please add comments to https://issues.oasis-open.org/browse/TCADMIN-4135.
-
OSLC Core Version 3.0: Link Guidance Version 1.0
Project Note 01
16 December 2021
https://docs.oasis-open-projects.org/oslc-op/link-guidance/v1.0/pn01/link-guidance.html
https://docs.oasis-open-projects.org/oslc-op/link-guidance/v1.0/pn01/link-guidance.pdf
-
-
- Please add comments to https://issues.oasis-open.org/browse/TCADMIN-4132.
***************************************
- Please add comments to https://issues.oasis-open.org/browse/TCADMIN-4132.
-
OSLC Tracked Resource Set Guidance Version 1.0
Project Note 01
16 December 2021
https://docs.oasis-open-projects.org/oslc-op/trs-guidance/v1.0/pn01/trs-guidance.html
https://docs.oasis-open-projects.org/oslc-op/trs-guidance/v1.0/pn01/trs-guidance.pdf
-
-
- Please add comments to https://issues.oasis-open.org/browse/TCADMIN-4136.
***************************************
- Please add comments to https://issues.oasis-open.org/browse/TCADMIN-4136.
-
Tracked Resource Set Primer Version 1.0
Project Note 01
16 December 2021
https://docs.oasis-open-projects.org/oslc-op/trs-primer/v1.0/pn01/trs-primer.html
https://docs.oasis-open-projects.org/oslc-op/trs-primer/v1.0/pn01/trs-primer.pdf
-
-
- Please add comments to https://issues.oasis-open.org/browse/TCADMIN-4137.
-
looks good to me. i approve to release
- Removed README warning file and reset directory timestamp in canonical directory on staging server.
- synced to OASIS OP Library (docs.oasis-open-projects.org)
- Ready for announcements.
Sent out announcement message to:
- project-announce@lists.oasis-open.org, members@lists.oasis-open.org, oslc-op@lists.oasis-open-projects.org, oslc-op-pgb@lists.oasis-open-projects.org
- emails:
Submitted announcement to OASIS website for review.
Assigning to Chet to review and complete announcement, etc.
The article is published on the website and announced on social media. I'm closing this ticket.
Source documents are listed in the announcement of intent to publish: https://lists.oasis-open-projects.org/g/oslc-op-pgb/message/204
Ballot results are listed in the ballot: https://lists.oasis-open-projects.org/g/oslc-op-pgb/message/209
Closing date of the ballot (approval date) is 16 December 2021.
This is one of a set of five Project Notes which we expect to publish and announce together. The titles and approved source documents (individual HTML files) are:
TCADMIN-4132)https://lists.oasis-open-projects.org/g/oslc-op-pgb/attachment/204/2/oslc-link-guidance.html
TCADMIN-4134)https://lists.oasis-open-projects.org/g/oslc-op-pgb/attachment/204/0/config-primer.html
TCADMIN-4135)https://lists.oasis-open-projects.org/g/oslc-op-pgb/attachment/204/1/core-3.0-changes.html
TCADMIN-4136)https://lists.oasis-open-projects.org/g/oslc-op-pgb/attachment/204/3/trs-guidance.html
TCADMIN-4137)https://lists.oasis-open-projects.org/g/oslc-op-pgb/attachment/204/4/trs-primer.html
Quick review shows that some changes for the title and URIs will be needed.
I'll assemble a list of the expected changes - likely for all of the PNs together.