Register w3id.org/trace namespace

[tmcphillips]

Summary

Register the trace/ top-level directory at w3id.org by submitting a PR to perma-id/w3id.org. This claims the https://w3id.org/trace/ namespace for the TRACE project and enables persistent URI resolution for TROV vocabulary terms.

What the .htaccess does

• Versioned content negotiation for w3id.org/trace/trov/{version} — serves Turtle, JSON-LD, RDF/XML, N-Triples, or HTML depending on the client's Accept header. Wildcard version matching so new versions work
• Unversioned and unmatched paths — serves a vocabulary index page for browsers; returns 406 Not Acceptable for RDF
  clients. Covers the root (w3id.org/trace/), unversioned vocabulary paths (w3id.org/trace/trov/), and anything else not
  matched above.
• Pre-release namespace w3id.org/trace/2023/05/trov — redirects to the pre-release migration docs.

Blocked by

• Create trace-vocabularies repo to serve as hub for TRACE vocabularies #20

Steps

• Fork perma-id/w3id.org
• Draft .htaccess with content negotiation rules
• Draft README.md with project info and maintainer contacts
• Write Mocha test suite (local Docker + remote modes)
• Create trace-vocabularies repo to serve as hub for TRACE vocabularies #20
• Run local Apache Docker tests against .htaccess
• Submit PR to perma-id/w3id.org
• Post-merge smoke test against live w3id.org
• Update documentation references across repos

Related

• Create vocabulary index page #15

Context

• TROV Versioning Strategy and Roadmap describes the redirect design.
• See also: Documentation Infrastructure -Testing the w3id.org redirect rules.

[tmcphillips]

The w3id.org PR has been merged: perma-id/w3id.org#5841

All 27 Mocha tests pass against the live server (npm run test:remote in trace-vocabularies/w3id/tests/):

  w3id.org redirect tests (remote mode)
    Versioned TROV URI — content negotiation
      ✔ T01: Turtle request returns 303 to trov.ttl
      ✔ T02: Turtle request with trailing slash
      ✔ T03: JSON-LD request returns 303 to trov.jsonld
      ✔ T04: RDF/XML request returns 303 to trov.rdf
      ✔ T05: N-Triples request returns 303 to trov.nt
      ✔ T06: Explicit text/html returns 303 to HTML page
      ✔ T07: No Accept header defaults to HTML page
      ✔ T08: Browser-style Accept header returns HTML page
    Wildcard version matching
      ✔ T09: Future version '1' works for Turtle
      ✔ T10: Future version '0.2' works for HTML
    Context file direct access
      ✔ T11: context.jsonld request redirects correctly
    Pre-release namespace (2023/05/trov)
      ✔ T12: Turtle request rewrites to trov/prerelease and redirects
      ✔ T13: JSON-LD request rewrites to trov/prerelease and redirects
      ✔ T14: HTML request rewrites to trov/prerelease and redirects
      ✔ T15: Trailing slash works
      ✔ T16: Context file through pre-release path
    Default fallback — browsers get vocabulary index
      ✔ T17: Root with browser Accept
      ✔ T18: Root with no Accept header gets 406
      ✔ T19: Unversioned trov with browser Accept
      ✔ T20: Unversioned trov with wildcard Accept
      ✔ T21: Unknown path with browser Accept
    Default fallback — RDF clients get 406
      ✔ T22: Unversioned trov with Turtle Accept
      ✔ T23: Unversioned trov with JSON-LD Accept
      ✔ T24: Root with Turtle Accept
      ✔ T25: Unknown path with RDF Accept
    Edge cases
      ✔ T26: Versioned URI with extra path segments falls to default
      ✔ T27: Trailing slash on unversioned trov

  27 passing (12s)