Skip to main content

Search the Commons

Type at least 2 letters. Use the arrow keys to move through results, Enter to open, Escape to close.

Ask a question instead: answers drawn from across the Commons, with links to the source. Or browse the site map.

Contribute and get help · Operating model and support

How the Commons runs, and how to get help

Who the Commons supports, the four tiers of help, who does what, and how a request becomes a released feature, through GitHub, with Jira and Confluence as optional mirrors. Written so that any team could run the Commons.

In short: a plain English summary
  • This page says how the Commons is run.
  • It says who does what.
  • It says how to get help and how quickly we reply.

Getting help: four tiers

0

Help yourself

The user guide, guided tours, tutorials, rule library, frameworks and FAQ.

Instant

1

Ask the community

The networks and the contributions library. Other members answer.

Best effort

2

Ask the Commons team

Questions, bugs and commissions, through the contact form or the GitHub forms. We never publish an email address.

Acknowledge in 2 working days; plan in 5. Accessibility: 1 working day.

3

Specialist teams

Anything needing an official decision, for example policy wording, the official DQMI, statistics regulation or data protection, goes to the owning team with your agreement.

As that team sets

Roles

RoleDoesTime
Service ownerOwns the roadmap, priorities and this operating model; chairs triage0.2 FTE
Product and deliveryRuns the backlog, releases and user research0.5 FTE
Maintainers (2 or more, from different organisations)Review changes; keep the Python toolkit, packs and browser engine in step (parity checked)0.1 FTE each
Content stewardsKeep frameworks, crosswalks, learning and networks current; verify "partly" entries0.1 FTE each
ModeratorsReview contributions, wishlist suggestions and survey free text1 hour a week (rota)
Accessibility championChecks every release against WCAG 2.2 AA; runs testing with assistive technology users0.1 FTE
AI assurance leadOwns the AI route: evaluations, ATRS records, human review rules0.1 FTE

Named people are kept in the team's own records, not published here.

From request to release

  1. RequestAnyone raises it: wishlist, a GitHub form, a commission or the contact form.
  2. Weekly triage30 minutes, open notes. Each item is labelled backlog, answered, community, specialist or declined (with the reason).
  3. BacklogEach backlog item is a GitHub issue, placed in the Now, Next, Later or Done milestone automatically, the same stages as the portal's roadmap. With Jira connected, the backlog label also creates a Jira story and comments its key back.
  4. PrioritiseMonthly: user value × reach × inclusion benefit ÷ effort. Ties go to accessibility and inclusion.
  5. BuildA pull request that passes tests, the parity check and accessibility checks, with docs changed in the same request.
  6. ReleaseMerging rebuilds and publishes the portal. A version tag makes a GitHub Release with notes, a source zip and the offline portal, and opens an inclusion review. Commits that say "Closes #n" close the issue. With Confluence connected, the docs are published there too.
  7. Tell peopleA changelog entry, the What's new panel, the GitHub Release (people who watch the repository for releases are notified) and a note to the networks.

GitHub, Jira and Confluence

Status: GitHub is live: issues, milestones, discussions, releases, Actions and Pages all run. The Jira and Confluence workflows run as dry runs until an owner adds their secrets (repository Settings, Secrets and variables, Actions); they log what they would do, so nothing breaks before then.

Moderation and contributions

How we'll know it's working

Reach

Organisations using the Commons, by type and nation, from opt-in surveys. We don't track people.

Outcomes

Critical assets with a measured baseline; issues resolved within their timescale.

Service

Time from request to first answer; commissions completed; open accessibility issues and their age.

Inclusion

Share of contributions from outside central government, and from each nation.