W3C QA - Review of OWL Semantics and Abstract Syntax (original) (raw)
This checklist includes all checkpoints from the QA Framework: Specification Guidelines [QAF-SPEC] presented in a tabular format. The checkpoints are presented by order of their priorities, which makes it an appropriate Implementation Conformance Statement for the guidelines.
These comments do not relate to the QA Spec Guidelines specifically, but have been made when evaluating and reading the OWL Semantics Specification. You can ignore them if you choose to do it.
To be A-conformant with the guidelines, the following Priority 1 checkpoints must be fulfilled:
Nbr
Checkpoint
Yes
No
N/A
Guideline 1. Define Scope.
Include the scope of the specification.
NO: The introduction doesn't say what are the application fields of the language. What are the possible usages of it.
Guideline 2. Identify what needs to conform and how.
Identify all classes of product.
YES: in the last chapter of your introduction, you define who and what will use this specification. You may work a bit more on it to detail a bit more and make a list with the different classes of products, you have identified: 1) parsers and syntactic tools 2) reasoners and semantic tools. No others classes of products?
For each class of product, define the conformance requirements.
NO: You didn't define the conformance requirements for each class of products and you do not have at all a conformance section.
Guideline 3. Specify conformance policy.
If special conformance terms are used, include a definition in the specification.
NO: Define a conformance section.
Justify any usage of a dimension of variability by reference to usage scenarios and requirements
NO: Define a conformance section.
Guideline 4. Address the use of profiles to divide the technology.
Indicate whether or not the use of profiles is mandatory for conformance.
N/A
Guideline 5. Address the use of modules to divide the technology.
If modules are chosen, indicate any mandatory conditions or constraints on their usage.
N/A
Guideline 7. Identify the relation between deprecated features and conformance.
Identify each deprecated feature.
N/A
For each class of product, specify the degree of support required for each deprecated feature and the conformance consequences of the deprecation.
N/A
Guideline 8. Define discretionary items.
State the circumstances for when discretionary items are allowed
N/A
For implementation dependencies, address the allowable differences between implementations
N/A
Guideline 9. Allow extensions or NOT!
Indicate if the specification is extensible.
NO: You should define if the extension are allowed or not.
If extensions are allowed, define their scope and constraints.
N/A: just because we don't know if the specification is extensible or not.
Prevent extensions from contradicting the specification.
N/A: just because we don't know if the specification is extensible or not.
Guideline 10. Provide a conformance clause.
Include a conformance section.
NO: You didn't provide any conformance clause. You have to give one explaining how the different classes of products should conform to your specification.
Guideline 11. Specify how to make conformance claims.
Identify and define all conformance designations.
N/A: Only because you don't have any conformance sections.
Impose no restrictions about who can make a claim or where claims can be published.
N/A: No conformance section.
Guideline 13. Clearly identify conformance requirements.
Use conformance key words.
NO: How one defines that he has done the right thing? How one knows what he must implement or not?
Distinguish normative and informative text.
NO: You do not define the section of your documents which are normative BUT you defined the informative ones. Please add after each section, not only the table of contents a sentence to indicate that this part is normative, or that part is informative.
Use consistent terminology.
YES: It seems correct, even if your text often lacks of clarity in the presentation, which doesn't help for reading and understanding it.
To be AA-conformant with the guidelines, the following Priority 2 checkpoints must be fulfilled (in addition to the above Priority 1 checkpoints):
Nbr
Checkpoint
Yes
No
N/A
Guideline 1. Define Scope.
Provide examples.
NO: The section example in your document is more about usage scenario. See below.
Guideline 3. Specify conformance policy.
Specify any universal requirements for minimum functionality.
NO: you don't define the minimal requirement even if you could because it seems you have levels.
Guideline 4. Address the use of profiles to divide the technology.
If profiles are chosen, define any minimal requirements.
N/A
If profiles are chosen, define their relationships and interaction with other dimensions of variability.
N/A
If profiles are chosen, address rules for profiles.
N/A
Guideline 5. Address the use of modules to divide the technology.
If modules are chosen, define their relationships and interaction with other dimensions of variability.
N/A
Guideline 6. Address the use of functional levels to divide the technology.
If levels are used, define their relationships and interaction with other dimensions of variability.
YES: You are using levels: OWL Lite -> OWL DL -> OWL Full (btw you don't say what DL means)
Guideline 8. Define discretionary items.
Indicate any constraints on the number of choices/options that can be implemented for discretionary choices
N/A
Promote consistent handling of discretionary choices.
N/A
Guideline 10. Provide a conformance clause.
Make normative reference to specifications on which the current specification depends
YES
Guideline 13. Clearly identify conformance requirements.
Provide a fast way to find conformance information
NO
Guideline 14. Provide test assertions.
Provide test assertions
NO: You have a test suite, but you don't provide in this document a way to know what is testable.
Provide a mapping between the specification and the test assertions list
NO: You don't have this list.
To be AAA-conformant with the guidelines, the following Priority 3 checkpoints must be fulfilled (in addition to the above Priority 1 and Priority 2 checkpoints):
Nbr
Checkpoint
Yes
No
N/A
Guideline 1. Define Scope.
Provide Usage Scenarios.
YES: but confusing because it has been noted examples.
Guideline 2. Identify what needs to conform and how.
Identify which of the categories of object are specified in the document as a whole.
NO
Guideline 7. Identify the relation between deprecated features and conformance.
Include an explanation for the deprecation.
N/A
Include examples to illustrate how to avoid using deprecated features.
N/A
Guideline 9. Allow extensions or NOT!
Define a uniform mechanism to create an extension.
N/A
Require that extensions be published.
N/A
Require that implementations provide interoperable alternatives to extensions
N/A
Guideline 11. Specify how to make conformance claims.
Provide specific wording of the claim.
N/A: make a conformance section.
Provide a conformance disclaimer.
N/A: provide a conformance clause
Guideline 12. Publish an Implementation Conformance Statement proforma.
Provide an Implementation Conformance Statement proforma.
N/A: because impossible to verify now.
Require the ICS be completed as part of the conformance claim.
N/A: because impossible to apply now.