# UK Legislation and Whole-Law OKF documentation

This is the maintained documentation spine for the UK Legislation OKF, its
legislation-specific Explorer behaviour and the additive Whole-Law federation.

## Current publication

The current published Legislation/Whole-Law bundle is
[v0.3.0](https://github.com/chris-page-gov/okf-uk-legislation/releases/tag/v0.3.0),
published on **27 July 2026** from commit
`3fd2700f275fff53d8605f38eb3257780ea591fa`. It uses the **OKF 0.2**
specification. The legislation catalogue snapshot is dated 11 July 2026 and
the Whole-Law source-access snapshot is dated 25 July 2026.

Some machine descriptors in the immutable release still carry their
pre-promotion `candidate`/`preview` labels; the release record is the
authoritative publication status. There is no Legislation/Whole-Law `v0.4.0`
release.

- [Open the hosted UK Legislation Explorer](https://chris-page-gov.github.io/okf-explorer/?bundle=https%3A%2F%2Fchris-page-gov.github.io%2Fokf-uk-legislation%2Fokf-explorer.json&view=reader#overview)
- [Open the hosted Whole-Law federation](https://chris-page-gov.github.io/okf-explorer/?bundle=https%3A%2F%2Fchris-page-gov.github.io%2Fokf-uk-legislation%2Fwhole-law%2Fokf-explorer.json&view=reader#overview)

## Choose your route

| If you need to… | Start here |
|---|---|
| open the pack and find an Act, instrument or provision | [Getting started](getting-started.md) |
| learn the interface through worked examples | [Illustrated persona manual](illustrated-manual.md) |
| understand who the pack serves and what success means | [Personas and user journeys](personas-and-user-journeys.md) |
| follow guidance tailored to your role | [Role guides](roles/index.md) |
| design an agent that answers with passage-level provenance | [Agent research guide](agent-research-guide.md) |
| understand completeness, ontology and official access methods | [Architecture and data model](uk-legislation-okf.md) |
| understand relationship composition | [Relationships](relationships.md) |
| inspect official effects and model-assisted enrichment | [Effects and enrichment](effects-and-enrichment.md) |
| understand Whole-Law sources, rights and access state | [Source coverage](source-coverage.md) |
| assess an AI answer or the Explorer itself | [Evaluation and quality](evaluation-and-quality.md) |
| refresh the corpus, evidence or documentation | [Maintenance guide](maintenance.md) |
| navigate all researched legal-source families | [Whole-Law documentation](../whole-law/docs/index.md) |

## Documentation layers

The spine keeps these concerns separate:

1. **Task guidance** — how a person finds and verifies legislation.
2. **Persona evidence** — whose needs and risks the interface serves.
3. **Technical contract** — ELI, Schema.org, CLML, YAML-LD, federation and
   provider-datapack contracts.
4. **Agent contract** — progressive discovery and proposition-level
   provenance.
5. **Authority and coverage** — official, derived and model-assisted
   relationships; source access and constraints.
6. **Assurance** — evaluation questions, scoring, validation and immutable
   audit evidence.

## Stable public entry points

| Publication | Repository | Canonical descriptor | Declared `raw_subpath` | Release/archive fallback |
|---|---|---|---|---|
| UK Legislation | [GitHub](https://github.com/chris-page-gov/okf-uk-legislation) | [root descriptor](https://chris-page-gov.github.io/okf-uk-legislation/okf-explorer.json) | `bundle` | [releases](https://github.com/chris-page-gov/okf-uk-legislation/releases) |
| UK Whole-Law | [GitHub](https://github.com/chris-page-gov/okf-uk-legislation) | [federation descriptor](https://chris-page-gov.github.io/okf-uk-legislation/whole-law/okf-explorer.json) | `bundle/whole-law` | [releases](https://github.com/chris-page-gov/okf-uk-legislation/releases) |

The maintained documentation is published at
`https://chris-page-gov.github.io/okf-uk-legislation/docs/`. The legislation
and Whole-Law evaluation routes are `/evaluation/` and
`/whole-law/evaluation/` beneath the same publication root.

Keep these source and worked-example routes available without path guessing:

- [legislation.gov.uk](https://www.legislation.gov.uk/) and its
  [official data/API documentation](https://legislation.github.io/data-documentation/);
- the official [data.gov.uk API documentation](https://guidance.data.gov.uk/get_data/api_documentation/);
- the [GOV.UK CKAN example descriptor](https://chris-page-gov.github.io/ai-engineering-lab-hackathon-london-2026/gov-ckan/okf-explorer.json);
- the preserved [OKF Bundle Wiki authoring guide](https://chris-page-gov.github.io/ai-infrastructure-wiki/docs/okf-bundle-authoring.md).

The original combined repository README and documentation remain at the
[compatibility site](https://chris-page-gov.github.io/ai-infrastructure-wiki/).
It preserves the [OKF Bundle authoring guide](https://chris-page-gov.github.io/ai-infrastructure-wiki/docs/okf-bundle-authoring.md),
[Explorer manual](https://chris-page-gov.github.io/ai-infrastructure-wiki/docs/use-okf-explorer.md)
and [GOV.UK CKAN example](https://chris-page-gov.github.io/okf-explorer/?bundle=https%3A%2F%2Fchris-page-gov.github.io%2Fai-engineering-lab-hackathon-london-2026%2Fgov-ckan%2Fokf-explorer.json&view=reader#overview).

## Boundaries

The pack is a legislation discovery and statutory-text research aid. It is not
a complete case-law database, citator, substitute for checking commencement
and territorial extent, legal advice or qualified practitioner assurance.
Topic labels are navigation aids rather than official legal classifications.

Use [legislation.gov.uk](https://www.legislation.gov.uk/) and its
[official data/API documentation](https://legislation.github.io/data-documentation/)
for authoritative source material.