# UK Legislation OKF Documentation

This is the maintained documentation spine for the UK Legislation OKF pack and its legislation-specific Explorer behaviour.

[Open the hosted UK Legislation Explorer](https://chris-page-gov.github.io/okf-explorer/?bundle=https%3A%2F%2Fchris-page-gov.github.io%2Fai-infrastructure-wiki%2Flegislation%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) |
| 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) |
| assess an AI answer or the Explorer itself | [Evaluation and quality](evaluation-and-quality.md) |
| refresh the corpus, screenshots or documentation | [Maintenance guide](maintenance.md) |

## Documentation layers

The spine keeps five concerns separate so each can be updated without rewriting everything:

1. **Task guidance** — how a person finds and verifies legislation.
2. **Persona evidence** — whose needs and risks the interface is designed around.
3. **Technical contract** — ELI, Schema.org, CLML, manifestations, APIs and corpus completeness.
4. **Agent contract** — progressive discovery and proposition-level provenance.
5. **Assurance** — evaluation questions, scoring, validation and screenshot refresh evidence.

## Stable public entry points

- Explorer: `https://chris-page-gov.github.io/okf-explorer/?bundle=https%3A%2F%2Fchris-page-gov.github.io%2Fai-infrastructure-wiki%2Flegislation%2Fokf-explorer.json&view=reader#overview`
- Bundle descriptor: `https://chris-page-gov.github.io/okf-uk-legislation/okf-explorer.json`
- Generated bundle wiki: `https://chris-page-gov.github.io/okf-uk-legislation/`
- Evaluation suite: `https://chris-page-gov.github.io/okf-uk-legislation/evaluation/`

## Boundaries

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