70 likes | 84 Views
This proposal aims to update the outdated schema file links in the v1.0 Specification, replacing them with stable RDDL document links.
E N D
#D8 Specification v1.0 Erratum #1 SDD 1.1 Proposal
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
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
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
Proposed Schema • N/A
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
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