Conformance Guide

Overview

The UOR conformance suite validates all workspace artifacts against professional standards. Run it with:

cargo run --bin uor-conformance

What Is Validated

Ontology Conformance

ArtifactStandardValidator
public/uor.foundation.jsonJSON-LD 1.1validators/ontology/jsonld.rs
public/uor.foundation.jsonOWL 2 DLvalidators/ontology/owl.rs
Inventory counts14/82/119/14validators/ontology/inventory.rs
public/uor.foundation.ttlRDF 1.1 / Turtle 1.1validators/ontology/rdf.rs
7 test instance graphsSHACLvalidators/ontology/shacl.rs

Documentation Conformance

CheckValidator
All 82 classes documentedvalidators/docs/completeness.rs
Namespace pages accuratevalidators/docs/accuracy.rs
Diataxis structure presentvalidators/docs/structure.rs
No broken internal linksvalidators/docs/links.rs

Website Conformance

CheckStandardValidator
HTML5 structureHTML5validators/website/html.rs
AccessibilityWCAG 2.1 AAvalidators/website/accessibility.rs
Namespace page coverage—validators/website/coverage.rs
CSS validityCSSvalidators/website/css.rs
Internal links—validators/website/links.rs

Adding a New SHACL Test

  1. Create conformance/src/tests/fixtures/test<n>_<name>.rs
  2. Define a pub const TEST<N>_<NAME>: &str = r#"..."#; with Turtle source
  3. Export it from conformance/src/tests/fixtures/mod.rs
  4. Register it in conformance/src/validators/ontology/shacl.rs
  5. Add a check function validate_<name>(src: &str) -> Result<(), String>

Running Individual Validators

The conformance library is structured so each validator can be called independently:

use uor_conformance::validators::ontology::owl;

let report = owl::validate();
assert!(report.all_passed());

CI Integration

The CI workflow runs full conformance as the last step:

- run: cargo run --bin uor-conformance  # exits non-zero on failure