1 / 7

Erratum #1: Update Schema File Links in Specification

This proposal aims to update the outdated schema file links in the v1.0 Specification, replacing them with stable RDDL document links.

mlombardi
Download Presentation

Erratum #1: Update Schema File Links in Specification

An Image/Link below is provided (as is) to download presentation Download Policy: Content on the Website is provided to you AS IS for your information and personal use and may not be sold / licensed / shared on other websites without getting consent from its author. Content is provided to you AS IS for your information and personal use only. Download presentation by click this link. While downloading, if for some reason you are not able to download a presentation, the publisher may have deleted the file from their server. During download, if you can't get a presentation, the file might be deleted by the publisher.

E N D

Presentation Transcript


  1. #D8 Specification v1.0 Erratum #1 SDD 1.1 Proposal

  2. Current Situation • V1.0 Standard Specification points to outdated schema files • We have approved and published updated schema files: • No changes in content, but latest version nomenclature is not included in specification • Filenames, import statements, etc. refer to “cs04…” schema files rather than “os…” files • Randy has updated the RDDL documents to point to the latest schema files • These are on the TC Documents Page

  3. Scenario(s)/Use Case(s) • Benjamin visits the OASIS SDD Documents Page • Reads specification (cover-to-cover  ) • Finds references in specification Appendix A to schema files and decides to study those • Clicks on schema link; gets 404/File Not Found • E-mails TC chair to find out why this Standard has this error • Or worse, assumes that SDD isn’t complete and isn’t worth pursuing

  4. Proposal • Process an erratum to the v1.0 Specification • In particular: • Replace the direct links to schema files in Appendix A of the specification with links to RDDL documents, which will remain stable and can be updated “out-of-band” if schema files change in the future, without additional errata to the specification • Changes require TC approval • Full Majority approval (51% of all voting members, not just those present) of the changes, and confirmation that changes are not substantive. Voice vote is sufficient. • 15-day public review, followed by Full Majority adoption by TC • No Web ballots required

  5. Proposed Schema • N/A

  6. Proposed Specification Change (1) Replace following text in Appendix A with text on next slide Schema File List The SDD schema is implemented by multiple schema files. Types defined in each file are identified by a specific namespace prefix, as indicated in the following list: • cd04-sdd-common-1.0.xsd (prefix: sdd-common) Contains definitions of common types used in the SDD specification, including identity and fix-identity types, UUID and version types, and the display text type. http://docs.oasis-open.org/sdd/v1.0/cs01/CL1Schema/cs01-sdd-common-1.0.xsd http://docs.oasis-open.org/sdd/v1.0/cs01/FullSchema/cs01-sdd-common-1.0.xsd • cd04-sdd-deploymentDescriptor-1.0.xsd (prefix: sdd-dd) Contains the deployment descriptor specification, including various content types. http://docs.oasis-open.org/sdd/v1.0/cs01/CL1Schema/cs01-sdd-deploymentDescriptor-1.0.xsd http://docs.oasis-open.org/sdd/v1.0/cs01/FullSchema/cs01-sdd-deploymentDescriptor-1.0.xsd • cd04-sdd-packageDescriptor-1.0.xsd (prefix: sdd-pd) Contains the package descriptor specification, including types related to packages and files. http://docs.oasis-open.org/sdd/v1.0/cs01/CL1Schema/cs01-sdd-packageDescriptor-1.0.xsd http://docs.oasis-open.org/sdd/v1.0/cs01/FullSchema/cs01-sdd-packageDescriptor-1.0.xsd

  7. Proposed Specification Change (2) Replacement text for text on previous slide Schema File List The SDD schema is implemented by multiple schema files. Types defined in each file are identified by a specific namespace prefix, as indicated in the following list • sdd-common-1.0.xsd (prefix: sdd-common) Contains definitions of common types used in the SDD specification, including identity and fix-identity types, UUID and version types, and the display text type. The following namespace document describes this namespace and contains a directory of links to related resources, including the CL1 and Full Schema files: http://docs.oasis-open.org/sdd/v1.0/os/sdd-common-rddl-1.0.html • sdd-deploymentDescriptor-1.0.xsd (prefix: sdd-dd) Contains the deployment descriptor specification, including various content types. The following namespace document describes this namespace and contains a directory of links to related resources, including the CL1 and Full Schema files: http://docs.oasis-open.org/sdd/v1.0/os/sdd-deploymentdescriptor-rddl-1.0.html • sdd-packageDescriptor-1.0.xsd (prefix: sdd-pd) Contains the package descriptor specification, including types related to packages and files. The following namespace document describes this namespace and contains a directory of links to related resources, including the CL1 and Full Schema files: http://docs.oasis-open.org/sdd/v1.0/os/sdd-packagedescriptor-rddl-1.0.html

More Related