Documentation and samples ownership

The SDK repository is canonical for executable sample source, public API compatibility, build/test evidence, and the machine-readable entrypoint inventory in config/public-surface.json. Changes to an SDK example or public surface land and pass compatibility gates here before they are projected elsewhere.

The honua-site repository owns the public, versioned samples/documentation catalog on honua.io and deployment of its browser artifacts. Site samples consume the deployed Honua demo server and approved AWS-hosted live datasets; the site does not become a second source tree for SDK examples.

The canonical v2 sample contract is owned by honua-sdk-js#540. It inventories every runnable root and docs example, separates learning track from support tier and lifecycle, reserves seven golden journey IDs, and generates both CI selection and presentation-safe site metadata. The showcase consumer work is tracked by honua-sdk-js#550.

Downstream tooling consumes the generated honua-site-samples.v2.json projection from a pinned SDK commit or published npm tarball. It must not infer stability from package.json export presence. The v1 sample contract remains available only as a frozen compatibility surface for consumers completing their v2 migration.