Skip to content
CAI
Software that uses CAICheck a score

alphagov/whitehall

49.2

Weak · 6 November 2026

38k

lines of production code

Ruby

primary language

4

measurements over time

CAI band scale
CAI trend line
CAI lens gauges

What this system is

Features

Add CRUD interface for worldwide organisation pages

Administrators can now create, edit, view, and delete pages associated with worldwide organisations. The new index page lists existing pages and translations, while the new and edit forms allow users to select a corporate information page type, enter a required summary with character counting, and add body content using the Govspeak editor. A dedicated confirmation screen is provided before deleting a page.

_app/views/admin/worldwide\_organisation\pages · high confidence

Add ability to create and delete editorial remarks

Users can now add internal notes to editions via a new 'New internal note' form and permanently remove them using a dedicated confirmation page. The creation interface uses the GOV.UK Design System with an explicit form action and a textarea for the note body, while the deletion flow requires explicit confirmation before removing the remark.

_app/views/admin/editorial\remarks · high confidence

Add admin interface for managing fields of operation

Administrators can now create, view, and edit fields of operation through a new set of views styled with the GOV.UK Design System. The index page lists existing fields with edit links, while the new and edit pages provide forms for entering the field name and description (using a Govspeak editor) and display a warning that changes appear instantly on the live site.

_app/views/admin/operational\fields · high confidence

Add admin interface for managing historical accounts

Administrators can now create, edit, and delete historical accounts for people with relevant role appointments. The new interface includes an index page listing existing accounts with view, edit, and delete actions, a form for creating or editing accounts (capturing summary, political parties, birth/death dates, body, major acts, and interesting facts), and a confirmation step for deletion. This feature is gated so that only people with roles supporting historical accounts can have them created or managed.

_app/views/admin/historical\accounts · high confidence

Add configurable content block templates for admin forms

New view templates have been added to the admin configurable content blocks area to support rendering various field types in edition forms. This includes templates for default string, textarea, date, select, and object blocks, as well as specific implementations for select-with-search-tagging (both single and ordered variants) and govspeak. These templates handle form field rendering, validation error display, and primary locale content visibility, enabling editors to configure and edit these specific content block types within the admin interface.

_app/views/admin/configurable\_content\blocks · high confidence

Add document management interface for collection groups

Users can now view, add, reorder, and remove documents within a specific document collection group. This change introduces the index page listing group members, a confirmation dialog for removals (renaming the action from 'Delete' to 'Remove'), and a dedicated reorder interface using drag-and-drop or up/down buttons. An unavailable document banner is also displayed when necessary.

_app/views/admin/document\_collection\_group\memberships · high confidence

Add promotional feature item creation and editing views

Admin users can now create and edit promotional feature items through new Design System-based forms. These views allow users to add an item title and URL, a required summary, and choose between uploading an image or entering a YouTube video URL (including a description for the video). Users can also manage multiple links associated with the item using an 'add another' pattern. A confirmation page is provided for deleting items, and a warning informs users that newly created items appear on the live site instantly.

_app/views/admin/promotional\_feature\items · high confidence

Add review reminder creation and editing forms

Admin users can now create and edit review reminders for documents. This change introduces new views for setting a review date and email address, using the GOVUK datetime fields component for date selection and standard input for the email address. A confirmation screen is also provided to allow users to delete an existing review reminder, displaying the current review date before finalizing the action.

_app/views/admin/review\reminders · high confidence

Add standard Rails binstubs and CI test runners

The application now includes a set of executable binstubs in the bin directory to streamline local development and CI execution. This adds standard Rails entry points (rails, rake, bundle, setup, update, dev) and introduces dedicated CI scripts: minitest-ci and cucumber-ci, which split tests across parallel CI nodes based on specific modes (ruby-only, assets-required, serial) and scenario tags, as well as a ci script for general continuous integration tasks. Additional binstubs for brakeman and rubocop are also added to enforce security and linting standards directly from the project root.

bin · high confidence

Add translation management views for worldwide organisation pages

Administrators can now create, edit, and delete translations for worldwide organisation pages. The new index view allows selecting a target language to start a new translation, the edit view provides required fields for translated summary and body with support for right-to-left languages, and the confirm\_destroy view enables removal of existing translations.

_app/views/admin/worldwide\_organisation\_page\translations · high confidence

Add unenqueued scheduled publications metric

The system now exposes a new Prometheus gauge metric, whitehall\_unenqueued\_scheduled\_publications, which tracks the number of scheduled editions that are due for publication but have not yet been enqueued for processing. This metric is calculated by subtracting the current queue size of ScheduledPublishingJob from the count of future scheduled editions, providing visibility into the backlog of pending scheduled publications.

lib/collectors · high confidence

Add worldwide office translation management interface

Administrators can now create, edit, and delete translations for worldwide office contact details. This change introduces new admin views (index, edit, confirm\_destroy) that allow users to select a target language, fill in translated fields such as title, address, and phone numbers using the GOV.UK Design System components, and confirm deletion of existing translations.

_app/views/admin/worldwide\_office\translations · high confidence

Added benchmarking and codebase metrics scripts; removed legacy script/rails

Developers can now use the new \script/benchmark\_edition\_search.rb\ to measure the performance of edition filtering queries against a local production database replica, and \script/codebase\_metrics\ to track repository statistics such as file counts, size, and route numbers. The legacy \script/rails\ file has been removed as it is no longer needed.

script · high confidence

Added blank form partial for Generic Editions

A new blank form partial (\_form.html.erb) has been added to the admin generic editions views, providing a reusable template for rendering generic edition forms in the admin interface.

_app/views/admin/generic\editions · high confidence

Admin interface for creating and managing corporate information pages

Administrators can now create, edit, and list corporate information pages for organisations through a new GOV.UK Design System interface. The index page lists existing pages with search and pagination, while the new and edit forms use the standard edition form helper to provide fields for type, summary, and body (with a visual govspeak editor), along with guidance for image attachments.

_app/views/admin/corporate\_information\pages · high confidence

Admin interface for managing edition change notes

Administrators can now view, edit, and delete specific change notes associated with an edition. The new interface includes a listing page that displays change notes in a table with date and content, alongside direct links to edit or delete individual entries. The edit view provides a textarea for modifying the note's text, while the delete flow presents a confirmation screen showing the current note and the publication date before removal.

_app/views/admin/contact\_translations, app/views/admin/edition\_change\notes · high confidence

Admin interface for managing emergency banners

Administrators can now view the current emergency banner settings, edit its configuration (including campaign class, heading, description, and link details), and remove it entirely. This change introduces the show, edit, and confirm\_destroy views for the emergency banner management section, providing a complete UI for creating, updating, and deleting banner content.

_app/views/admin/emergency\banner · high confidence

Consultation admin form now supports opening/closing dates and response file management

The consultation creation and editing interface has been updated to include specific date fields for when a consultation opens and closes, allowing admins to set precise timestamps. Additionally, the form now provides a dedicated section for managing consultation responses, enabling admins to upload, keep, remove, or replace downloadable response files (such as PDFs) and enter contact details like email addresses and postal addresses for participation.

app/views/admin/consultations · high confidence

Administrators can now view the results of link checks directly within the application. The new view renders a report that categorizes links as 'danger', 'broken', or 'caution', providing details and suggested fixes for each issue via expandable sections. It also indicates when links to draft documents were skipped and displays the timestamp of the last check. The interface supports asynchronous updates to show progress while a report is being generated.

_app/views/admin/link\_check\reports · high confidence

Fatality notices now support multiple casualties and operational associations

The fatality notice editing interface has been updated to allow users to record multiple casualties via an 'add another' pattern, where each casualty entry includes a personal details field. The form also introduces a required 'Roll call info' section for field of operation introductions and groups associations (organisations, appointments/ministers, and operational fields) into a dedicated section, replacing previous single-record limitations.

_app/views/admin/fatality\notices · high confidence

Initial project scaffolding and configuration

The repository is initialized with the Whitehall application, establishing the foundational configuration for development and deployment. This includes setting the Ruby version to 3.3.6, defining the Docker build process with multi-stage builds for asset precompilation, and configuring the application to run via Unicorn and Sidekiq. Standard tooling is introduced, including RuboCop for Ruby linting, ESLint and Prettier for JavaScript, and Stylelint for CSS, alongside a new MIT license and updated documentation.

(repo-wide) · high confidence

Introduce admin 'What's New' page with structured update sections

Adds a new admin interface for the 'What's New' page, featuring a structured layout with distinct sections for introduction, upcoming changes, recent changes, and guidance. The page includes a dynamic table of contents that conditionally links to the upcoming changes section only when updates are present, and utilizes partials to render individual updates with area captions, headings, dates, and type-specific color-coded tags (new, improvement, change, fix).

_app/views/admin/whats\new · high confidence

Introduce configurable content block system

A new system for defining and rendering configurable content blocks has been added, allowing document types to be structured via schema-driven fields. This includes a base block class and specific implementations for arrays, dates, objects, selects, strings, textareas, govspeak, and search-tagging selects. The system supports nested field iteration, custom 'Add another' button text for arrays, and explicit mapping of form fields to schema attributes, enabling more flexible and consistent content editing interfaces.

_app/models/configurable\_content\blocks · high confidence

Introduce full admin interface for managing roles

Admins can now create, edit, list, and delete roles through a new GDS Design System-based interface. The roles index page displays a filterable table of existing roles with options to edit or delete them. The new and edit forms allow configuration of role titles, types, associated organisations, whip organisations, payment types, cabinet attendance, and responsibilities via a govspeak editor. A dedicated appointments tab enables admins to create new or previous appointments for a role. A confirmation step is required before deleting a role.

app/views/admin/roles · high confidence

Introduce new Publishing API presenters and base infrastructure

This change introduces a new \BaseItemPresenter\ to standardize common attributes (title, locale, update type, publishing app) across the Publishing API payload generation. It also adds a comprehensive suite of new presenters for content types including \CallForEvidence\, \Consultation\, \Contact\, \CorporateInformationPage\, \DetailedGuide\, \DocumentCollection\, \EmbassiesIndex\, \FatalityNotice\, \Government\, \HistoricalAccount\, \HistoricalAccountsIndex\, \HowGovernmentWorks\, \HtmlAttachment\, \MinistersIndex\, \OperationalField\, \OperationalFieldsIndex\, and \Organisation\. These presenters define the specific schema, links, and details required for each content type when publishing to the API.

_app/presenters/publishing\api · high confidence

Introduce new design system layout for admin pages

A new \design\_system.html.erb\ layout has been added to replace the previous \application.html.erb\ layout. This new layout integrates GOV.UK Frontend components for the header, footer, and page structure, enabling consistent styling and navigation across the admin interface. It includes built-in support for Google Analytics 4 (GA4) tracking via data attributes and modules, handles error summaries and flash messages using specific components, and allows for flexible column widths (full or two-thirds) based on content requirements.

app/views/layouts · high confidence

Introduce new lib modules for publishing, localization, and service configuration

This change adds a suite of new library files to the application core. It introduces \PublishesToPublishingApi\ and \PresentPageToPublishingApi\ to handle publishing workflows and link patching via the Publishing API, and \HasContentId\ to manage UUID generation and validation. Localization is enhanced with new \Locale\, \LocalisedModel\, and \TranslatableModel\ classes to support multi-language content and association localisation. Infrastructure improvements include a new \Services\ module for centralized API client configuration (Publishing API, Asset Manager, Search API) using Plek, and \PoliticalContentIdentifier\ to determine content political status. Additional utilities include \S3FileHandler\ for S3 storage, \Dependable\ for managing edition dependencies, and \MailRecipientInterceptor\ for email interception in non-production environments.

lib · high confidence

Introduce previewable GovSpeak editor, client-side image cropper, and searchable Miller columns

This change introduces three new JavaScript components to the admin interface. The GovSpeak editor now supports a preview mode, allowing users to render and verify their content before saving, including support for images and attachments. A new client-side image cropper component enables users to crop images directly in the browser with configurable aspect ratios and visual outlines. Additionally, a Miller columns component has been added with search capabilities, replacing the previous autocomplete implementation to help users select topics more efficiently.

app/assets/javascripts/components · high confidence

Introduces configurable document types and new reminder models

This change introduces a new \ConfigurableDocumentType\ model that loads document type definitions from JSON files in \app/models/configurable\_document\_types/\, allowing document schemas, forms, and settings to be configured externally rather than hardcoded. It also adds \CallForEvidenceReminder\ and \ConsultationReminder\ models to handle automated email notifications for these specific content types, including logic to obfuscate author email addresses in logs.

app/models · high confidence

Introduction of a new hand-rolled authority and permission enforcement system

A new custom authorization framework has been added to the Whitehall admin interface, replacing previous permission logic with a structured rules-based system. The \Enforcer\ class now manages access control by mapping specific subject types (such as Documents, Editions, MinisterialRoles, and SocialMediaAccounts) to dedicated rule sets, allowing for granular permission checks via a \can?\ interface. This change introduces specific error handling for denied or invalid actions and establishes the foundational architecture for managing editor access across various content types and administrative functions.

lib/whitehall/authority · high confidence

Manage editionable social media accounts

Admin users can now add, edit, delete, and reorder social media accounts linked to an edition. The new interface includes an index page listing existing accounts, forms for creating and editing accounts (using a service selector and URL/title fields), a confirmation dialog for deletion, and a dedicated reorder view using a drag-and-drop list component.

_app/views/admin/editionable\_social\_media\accounts · high confidence

Migrate legacy Topical Events to Standard Edition

The system now supports migrating legacy Topical Events into the new Standard Edition format. This change introduces a \StandardEditionMigrator\ with a \TopicalEventRecipe\ that maps legacy data to the new structure, including carrying over titles, summaries, body content (normalized to block content), social media links, lead and supporting organisations, and featured documents. It also handles specific legacy-to-new mappings such as converting the old logo image to the new images array, ignoring obsolete fields like duration and atom routes, and ensuring correct state and timestamp preservation. Topical Events with 'About' pages are currently unsupported and will abort the migration.

_app/services/standard\_edition\migrator · high confidence

New 'About' page for organisations in the admin interface

A new view has been added at app/views/admin/organisations\_about/show.html.erb, exposing an 'About' endpoint for organisations in the admin area. This page displays the organisation's name, a link to view it on the public website, and a secondary navigation menu. It conditionally renders a summary card containing the 'About us' summary and body text (truncated to 500 characters) if available, or shows an inset text message stating 'No about us page.' if the content is missing. The page also includes a back link to the main organisations list.

_app/views/admin/organisations\about · high confidence

A new 'More' page has been added to the admin interface, providing a centralized list of links for managing various content and system settings. Users can now access sections for cabinet ministers, emergency banners, fields of operation, governments, policy groups, organisations, people, roles, sitewide settings, topical events, world location news, worldwide organisations, republishing content, and retagging content directly from this single view.

app/views/admin/more · high confidence

New GA4 analytics modules for admin forms, search, and finders

This change introduces a suite of new JavaScript modules in the admin analytics directory to track user interactions via Google Analytics 4. Specifically, it adds \Ga4ButtonSetup\ to track non-submit button clicks using the 'select\_content' event, \Ga4FormSetup\ to monitor form changes and submissions (excluding finder and existing form trackers), \Ga4SearchSetup\ and \Ga4SearchResultsSetup\ to track search queries and result clicks within ecommerce-style tables, \Ga4FinderSetup\ to handle change events in finder components, \Ga4IndexSectionSetup\ to assign indices to form elements for structured data, and \Ga4PasteTracker\ to detect paste actions. These modules collectively replace previous tracking mechanisms with a more granular, module-based approach for admin interface analytics.

app/assets/javascripts/admin/analytics-modules · high confidence

New Whitehall bookmarklets for navigating from frontend to admin

Admin users can now use two new bookmarklets to quickly jump from public-facing pages to their corresponding admin areas in Whitehall. The 'Find in admin' bookmarklet detects the current page type (such as announcements, organisations, topics, or world locations) and redirects to the relevant admin section, falling back to content ID lookup for other document types. A second bookmarklet, 'Find a PDF publication page in Whitehall', allows users on a PDF page to be redirected to the Whitehall document where that PDF was originally attached.

app/views/admin/bookmarklets · high confidence

New address formatters for JSON and plain text output

The address formatter library now supports rendering addresses as JSON and plain text, in addition to the existing HTML (hCard) format. The new JSON formatter outputs structured data including an 'adr' object with individual address components and a 'label' field containing the formatted text address, with an optional 'type' key. The new plain text formatter strips excessive blank lines and leading/trailing whitespace to produce clean, readable text output. These additions allow consumers of the address formatter to choose the output format that best suits their integration needs.

_lib/address\formatter · high confidence

New admin JavaScript modules for cache busting, document history, image processing, and accessibility

Added several new GOVUK Modules to the admin interface: CachebustLink refreshes cache-busting query parameters on link activation to prevent stale URLs; DocumentHistoryPaginator enables asynchronous pagination and filtering within the Document History tab without full page reloads; ImageProcessingChecker polls for image processing completion and updates the preview or shows a failure state; LocaleSwitcher dynamically sets the text direction (RTL/LTR) on form fields when a language is selected; NavbarToggle improves keyboard accessibility for the navigation menu; PasteHtmlToGovspeak converts pasted HTML to Govspeak; and PreventMultipleFormSubmissions disables submit buttons upon form submission to prevent duplicate requests.

app/assets/javascripts/admin/modules · high confidence

New admin interface for creating and editing Topical Event about pages

Administrators can now create, view, and edit 'about pages' for topical events via a new set of admin views. The interface includes a form for entering the page name, read-more link text, summary, and body content (using a Govspeak editor), along with a summary list view for existing pages and a dedicated 'Create new' action when none exists. The edit and new views feature a warning that changes appear instantly on the live site and include a help sidebar.

_app/views/admin/topical\_event\_about\pages · high confidence

New admin interface for republishing content

Administrators can now republish content directly from the admin interface. The new 'Republish content' index page provides links to schedule republishing for individual pages, organisations, people, roles, and documents, as well as bulk republishing tasks. Each content type has a dedicated 'find' page where the slug is entered and a 'confirm' page that displays the target item and any associated editions before the action is executed.

app/views/admin/republishing · high confidence

New admin preview page for Govspeak content

A new preview interface has been added at app/views/admin/preview/preview.html.erb, allowing administrators to render Govspeak content with embedded images and attachments. The view calls the govspeak\_to\_html helper with a preview flag, ensuring that the rendered output reflects how the content will appear when published, including handling of alternative format contact emails and uploaded attachments.

app/views/admin/preview · high confidence

Administrators can now manage external website links and topical events directly from the feature lists interface, with dedicated partials displaying these items in tables with edit, feature, and delete actions. A new reorder page allows admins to adjust the display order of currently featured documents using drag-and-drop or up/down buttons, with the published date shown for each item to aid decision-making.

_app/views/admin/feature\lists · high confidence

New and consolidated Rake tasks for administration, maintenance, and testing

This change introduces a comprehensive suite of new Rake tasks in lib/tasks to support content administration, data hygiene, and operational maintenance. Key additions include tasks for merging duplicate person records and reassigning speeches (data\_hygiene), managing election-related content such as ending ministerial appointments and marking content as political (election), and bulk reslugging of entities like people, roles, organisations, and HTML attachments (reslugging). Operational capabilities are expanded with tasks to requeue all scheduled publishing jobs, send review and consultation reminders, display Sidekiq queue statistics, and rebuild the taxonomy cache. The update also adds reporting tools to identify invalid editions and search for specific Govspeak patterns, alongside new asset compilation hooks for Rails 7 compatibility and dedicated tasks for running linting, Jasmine, and Cucumber tests.

lib/tasks · high confidence

New bulk retagging interface for updating content organisations

Administrators can now use a new 'Retag content' page to bulk-update the lead, supporting, and access-limiting organisations for multiple documents. The workflow involves pasting CSV data into a text area to preview the proposed changes in a summary table, which displays the document slugs and the new organisation assignments, before confirming and publishing the updates.

app/views/admin/retagging · high confidence

New component library for content editing and navigation

This update introduces a suite of new view components to standardize the editing interface and navigation structures. Key additions include \datetime\_fields\ for structured date and time input, \govspeak\_editor\ for Markdown content editing with preview capabilities, and \image\_cropper\ for managing image assets with aspect-ratio support. The update also adds \translated\_input\ and \translated\_textarea\ components to display original English text alongside translations, \miller\_columns\ for hierarchical topic selection, and new navigation components (\secondary\_navigation\, \sub\_navigation\, \child\_of\_banner\) to improve content hierarchy visibility. Additionally, \summary\_card\ and \summary\_card\_list\ components are provided for displaying structured data summaries, while \inset\_prompt\ and \single\_image\_upload\ enhance form feedback and media handling.

app/views/components · high confidence

New component styles for navigation, content editing, and media management

This change introduces SCSS stylesheets for a suite of new administrative interface components. It adds styling for a 'Child of Banner' and 'Sub-navigation' to structure content hierarchy, alongside 'Secondary Navigation' and 'Miller Columns' for complex topic selection and browsing. For content creation, styles are provided for a 'GovSpeak Editor' with preview capabilities, 'Datetime Fields' for date/time input, and an 'Inset Prompt' for contextual messages. Media handling is supported with styles for an 'Image Cropper' (including control buttons and focus states), 'Single Image Upload', and a 'Loading Spinner'. Finally, a 'Summary Card' component is styled to improve the presentation of summary lists.

app/assets/stylesheets/components · high confidence

New data hygiene tools for bulk organisation updates, HTML attachment redirects, and document restoration

This change introduces several new capabilities in the lib/data\_hygiene area to help manage content data. A new BulkOrganisationUpdater allows users to update lead, supporting, and access-limiting organisations for documents (including Statistics Announcements) via a CSV file, providing a summary of changes and handling both published and draft editions. A PublishingApiHtmlAttachmentRedirector enables redirecting HTML attachments to a new destination, with support for dry runs. Additionally, a DeletedDocumentRestorer allows reinstating deleted documents by creating a new draft from the deleted edition, and various error classes (ChangeNoteNotFound, EditionNotUnpublished, HtmlAttachmentsNotFound) are added to support these operations.

_lib/data\hygiene · high confidence

New decorator for paginated timeline version items

A new decorator class has been added to handle version items within the paginated timeline. This component provides specific logic for determining the action type (such as 'created', 'editioned', or 'updated') based on edition context and event data, and includes methods to compare version IDs against specific editions to identify if they are newer, current, or older. It also optimizes performance by utilizing preloaded previous version data to avoid N+1 queries when accessing version history.

app/decorators · high confidence

New document collection search workflow with title and URL options

Administrators can now add documents to a collection group using a dedicated three-step flow: first selecting a search method (by title or by URL), then searching via title with state visibility and tracking, or entering a URL directly. The new 'Add by title' view displays edition states in search results, restricts the 'Add' button to pre-publication documents, and includes GA4 tracking attributes for analytics.

_app/views/admin/document\_collection\_group\_document\search · high confidence

New document connection interface for statistics announcements

Administrators can now connect existing documents to a statistics announcement via a new index page. This interface provides a search form to filter documents by title or slug, displays matching results in a paginated table, and offers 'View' and 'Connect' actions for each result. The page includes guidance on document type matching and integrates GA4 tracking attributes for search and interaction analytics.

_app/views/admin/statistics\_announcement\publications · high confidence

New email notification templates for publishing workflows

Added new email templates for key publishing events, including reminders for Call for Evidence and consultation deadlines, notifications for edition publication and rejection, fact-check requests and responses, document list downloads, and content review reminders. These templates provide users with timely updates and guidance links to help manage content lifecycle tasks effectively.

_app/views/mail\notifications · high confidence

New form and list views for statistical data sets

Writers can now create and manage statistical data sets through a new admin interface. The creation form provides guidance on when to use this format (for frequently updated live data) versus publications, and includes an associations section for linking to organisations. A list view has also been added to display statistical data sets with links to their individual edit pages.

_app/views/admin/statistical\_data\sets · high confidence

New helper modules for attachments, errors, and document metadata

The application introduces several new helper modules to support the updated attachment and document handling workflows. AttachmentsHelper provides error summary rendering and success notifications for file uploads, while DocumentHelper generates human-readable metadata (such as file type, size, and ISBN) for attachments. ErrorsHelper standardizes error display for form inputs and flash messages. GovspeakHelper is expanded to support inline attachments and embedded contacts, and OrganisationHelper manages definite articles and parental relationship text for organisations. Additional helpers include ComponentGuideHelper to fix broken component guide links, PluralizeHelper for custom pluralization, and TranslationHelper for locale-aware translation links.

app/helpers · high confidence

New image management interface for editions

Administrators now have a dedicated interface to manage images within editions, including uploading, editing details, cropping, and deleting images. The new views introduce an index page that groups images by usage type (single vs. multiple), an edit page with an image cropper and caption/credit fields, a confirmation page for deletion, and a specific workflow to toggle whether an edition uses a custom lead image or falls back to the organisation default.

_app/views/admin/edition\images · high confidence

New interface for managing and reordering organisation people

Admin users can now view people associated with an organisation, grouped by role type (such as Ministers, Management, or Military) in a tabbed list, and reorder these roles using a dedicated drag-and-drop interface. The new views include a back link to the main organisations list, display whether roles are occupied or vacant, and provide direct links to edit the role or the person holding it.

_app/views/admin/organisation\people · high confidence

New interface for managing document collection group memberships

Administrators can now view, reorder, and remove documents within specific groups of a document collection. This change introduces the Document Collection Group Memberships index page, which lists group members and provides links to add or reorder documents. A new reorder interface allows users to adjust the display order of documents using drag-and-drop or up/down buttons, while a dedicated confirmation page clarifies the action by labeling the removal button as 'Remove' instead of 'Delete'. Additionally, a warning banner is displayed if any documents in the group are currently unavailable.

_app/views/admin/topical\_event\_featurings, app/views/admin/worldwide\offices · high confidence

New interface for updating edition access controls

Admins can now explicitly update the access limitations of an edition via a dedicated edit page. This view presents a form to modify access-limiting organizations and requires a mandatory editorial remark explaining the change, along with a cancel link to return to the edition details.

_app/views/admin/edition\_access\limited · high confidence

New interface to manage and reorder lead and supporting organisations for topical events

Administrators can now view, toggle, and reorder organisations associated with a topical event. The new index page displays separate tables for lead and supporting organisations, allowing users to toggle an organisation's role between the two. For lead organisations, a dedicated reorder page is available, enabling administrators to adjust the display order using drag-and-drop or up/down buttons.

_app/views/admin/topical\_event\organisations · high confidence

New interface to unpublish statistics announcements

Administrators can now remove statistics announcements from GOV.UK via a new 'Unpublish statistics announcement' page. The form requires a redirect URL to which users will be sent, and provides guidance on when to use this action (e.g., for duplicates or errors). A destructive 'Unpublish announcement' button submits the change, while a 'Cancel' link returns to the announcement details.

_app/views/admin/statistics\_announcement\unpublishings · high confidence

New internal library components for Whitehall administration and publishing

This change introduces several new internal classes within the Whitehall library to support administration and publishing workflows. It adds \AdminLinkLookup\ to resolve internal admin URLs to specific editions or corporate information pages, and \AssetManagerStorage\ to handle file storage, deletion, and URL generation via the Asset Manager. The \PublishingApi\ class is introduced as a central interface for publishing, saving drafts, patching links, and managing asynchronous jobs for scheduling, unpublishing, and republishing content. Additionally, it includes \DataMigration\ and \DataMigrator\ for executing database migrations, \ImageKinds\ for configuring image variants and formats, \RandomKey\ for generating unique public identifiers, and \WhipOrganisation\ to define and sort whip roles.

lib/whitehall · high confidence

New model concerns for asset management, document replacement, and reshuffle handling

This change introduces several new model concerns to \app/models/concerns/\ that refactor and extend core document behaviors. The \AssetData\ concern centralizes asset-related logic, including attachment selection, access limitation, and draft status checks. The \Replaceable\ concern enables documents to be replaced by newer versions, handling asset migration and filename uniqueness. The \ReshuffleMode\ concern encapsulates logic for ministerial reshuffles, ensuring the ministers index page is patched rather than republished and that the 'How Government Works' page uses the correct presenter based on reshuffle status. Additional concerns include \DateValidation\ for handling configurable document date inputs, \AuditTrail\ for versioning and user alerts, \SimpleWorkflow\ for basic state management, \UserOrderable\ for reordering records, \Featurable\ for feature lists, \HasCorporateInformationPageType\ for corporate information pages, and \AssetDeletionBehaviour\ for asset deletion.

app/models/concerns · high confidence

New paginated timeline query for document history

A new PaginatedTimelineQuery class has been introduced to retrieve a document's activity timeline with pagination support. This query fetches a combined list of document versions and editorial remarks, ordered by creation date, and supports filtering to show only versions ('history') or only remarks ('internal\_notes'). Results are returned in pages of 10 items, including the model type, ID, and creation timestamp for each entry, along with helper methods to extract specific IDs for remarks or versions.

app/queries · high confidence

New presenters for document exports, social media accounts, emergency banners, and publishing API routing

This change introduces several new presenter classes in the app/presenters directory to support specific UI and export functionalities. The DocumentListExportPresenter generates CSV exports for document lists, including columns for public/admin URLs, titles, organizations, publication states, attachments, collections, history mode status, primary language, available translations, and summaries, while formatting booleans as 'yes'/'no' and arrays with pipe separators. The EditionableSocialMediaAccountsIndexPresenter renders social media accounts for an edition, displaying translated account titles and providing edit/delete actions. The EmergencyBannerPresenter formats current emergency banner data (campaign class, heading, description, link) for display. Additionally, the PublishingApiPresenters module provides a centralized factory method to retrieve the correct presenter for a given model, and the UseSlugAsParam module standardizes the to\_param method to use slugs.

app/presenters · high confidence

New rake tasks to republish documents based on attachment criteria

Added five new rake tasks in lib/tasks/attachments that identify and enqueue documents for republishing via the Publishing API based on specific attachment conditions: documents with non-PDF attachments (filterable by content type, time, and state), documents with inaccessible attachments for all organizations, documents with draft HTML attachments linked to consultation responses, documents with historically political HTML attachments, and documents with HTML attachments and national inapplicabilities.

lib/tasks/attachments · high confidence

New service objects for edition lifecycle and bulk operations

The application now uses dedicated service objects in app/services to manage edition workflows, replacing previous inline logic. Key additions include EditionPublisher, EditionScheduler, EditionUnpublisher, and EditionWithdrawer for state transitions, along with BulkRepublisher for mass content updates and StandardEditionMigrator for migrating legacy content types. The system also introduces DraftEditionUpdater for saving changes, LinkCheckerApiService for validating links, and EditionAuthBypassUpdater/Revoker for managing access controls on assets. These services centralize validation, error handling, and Publishing API interactions, ensuring consistent behavior across publishing, scheduling, unpublishing, and deletion actions.

app/services · high confidence

New string helpers and eager-loading fix for translated associations

Added \possessive\ and \articleize\ methods to the \String\ class to simplify text formatting. Additionally, introduced a \with\_translations\_for\ scope to \ActiveRecord::Base\ that enables eager loading of translations for associated objects, resolving an issue where the standard \includes\ approach failed to find the \translations\ association.

lib/patches · high confidence

New summary card component for worldwide organisation pages

Admin users now see a dedicated summary card component on the worldwide organisation pages index, displaying truncated summary and body text for each page. This component also provides direct action links to edit the page, add translations where missing, and initiate the delete process, with routing logic that correctly handles both default and non-English translations.

_app/components/admin/worldwide\_organisation\pages · high confidence

New summary card for worldwide office index

The worldwide offices index page now displays each office using a new summary card component. This card presents key details such as office type, contact information, services, and access times, and provides action links to edit, add translations, or delete the office entry.

_app/components/admin/worldwide\offices · high confidence

Administrators now have a dedicated view component (\FeaturedDocumentsTableComponent\) to display featured documents within topical events. This component renders a table showing the document title, type (distinguishing between internal editions and external offsite links), and the published date. It also provides action links to edit or unfeature each item, improving the clarity and structure of the features management interface.

_app/components/admin/topical\events · high confidence

New translation editing interface for standard editions

Administrators can now edit translations for standard editions via a dedicated form that includes fields for translated title and summary, with support for right-to-left languages. The interface renders all config-driven content blocks and provides access to help documentation and document history through a tabbed sidebar.

_app/views/admin/standard\_edition\translations · high confidence

New worldwide tagging interface for editions

A new edit page has been added for managing worldwide tags on editions, featuring a Miller columns component for selecting taxons and a confirmation notice that changes apply immediately to live pages.

_app/views/admin/edition\_world\tags · high confidence

Pagination added to the document history view

The document history component now supports paginated navigation, allowing users to browse through older and newer entries using 'Older' and 'Newer' links. The implementation uses Kaminari partials for the paginator and ensures that the 'editing' state is preserved as a query parameter during remote pagination requests.

app/views/kaminari/history · high confidence

Support for configurable document types and structured content management

The standard editions interface now supports configurable document types, allowing users to select a specific document type when creating a new document and change the type of existing draft, submitted, or rejected editions via a dedicated preview flow. The form has been restructured into tabbed sections, with a new 'Content' tab that includes title, summary, and configurable content blocks, alongside settings for language, scheduling, and access limiting. New capabilities include managing child pages, featuring documents on the edition, and adding offsite links, all integrated into the edition's navigation tabs.

_app/views/admin/standard\editions · high confidence

Removals

Removed legacy application README template

The file doc/README\_FOR\_APP has been deleted. This file previously served as a template for introducing the application and directing users to API documentation generated via rake tasks; its removal indicates that this manual documentation approach is no longer used or maintained.

doc · high confidence

Architecture

Admin helpers reorganized into dedicated modules

The admin helper logic has been split from monolithic files into specific, single-responsibility modules (e.g., AttachableHelper, BasePathHelper, ContactsHelper, EditionActionsHelper, PaginationHelper, RepublishingHelper, TabbedNavHelper). This reorganization groups related functionality—such as URL mapping, attachment handling, navigation tabs, and bulk republishing metadata—into their own files, improving maintainability and clarity for the admin interface.

app/helpers/admin · high confidence

Refactored Govspeak extractors and error handling into dedicated modules

The Govspeak library has been restructured to improve code organization and reusability. Contact and edition extraction logic has been moved into new, dedicated classes (\ContactsExtractor\ and \DependableEditionsExtractor\) that rely on a shared \EmbeddedContentPatterns\ module for regex definitions. Additionally, the \OrphanedHeadingError\ class has been extracted into its own file to better isolate error handling. These changes primarily affect internal code structure and do not introduce new user-facing features.

lib/govspeak · high confidence

Behavioural changes

Add SanitizedFile class with zero\_size? method

A new SanitizedFile class has been introduced within the CarrierWave library, providing a zero\_size? method that checks if the file size is zero. This change supports the library's internal file handling logic by offering a dedicated way to detect empty files.

_lib/carrier\wave · high confidence

Add bulk republishing by content type, organisation, and content ID

Admin users can now trigger bulk republishing operations using three new criteria: specific content types, organisations (via slug), or a list of content IDs. This replaces the previous 'all' option with targeted selection, allowing users to queue republishing for documents associated with a specific organisation, re-present documents matching given content IDs while retaining their current state, or republish all documents of a chosen content type.

_app/views/admin/bulk\republishing · high confidence

Add conditional S3 healthcheck for Whitehall Backend

A new S3 healthcheck has been added to the healthcheck library. This check verifies connectivity to the configured AWS S3 bucket using the S3FileHandler. It is designed to run only when the environment variable RUN\_S3\_HEALTHCHECK\_FOR\_WHITEHALL\_BACKEND is present, ensuring it is skipped during E2E tests or in non-Whitehall Backend contexts. If the connection or bucket retrieval fails, the healthcheck reports a critical status; otherwise, it reports OK.

lib/healthcheck · high confidence

Added GA4 configuration and IE11 compatibility support for admin

The admin interface now includes a new domain configuration file that defines settings for Google Analytics 4 (GA4) across production, staging, and integration environments, including specific container IDs and authentication tokens. Additionally, a new script has been introduced to prevent JavaScript execution in Internet Explorer 11 by disabling ES6 module support and removing the 'js-enabled' class, ensuring the GOV.UK Frontend does not initialize in unsupported browsers.

app/assets/javascripts/admin · high confidence

Admin UI components refactored with GA4 tracking and GOV.UK Design System alignment

The admin interface now uses dedicated ViewComponents for key UI elements, introducing Google Analytics 4 (GA4) tracking for error summaries, flash notices, and flash alerts while removing legacy Universal Analytics code. The ErrorSummaryComponent has been rewritten to support error object inputs, sort messages by a designated field order, allow custom error labels, and correctly format dotted array attributes. The new CurrentlyFeaturedTabComponent presents featured pages in a GOV.UK Design System-compliant layout, distinguishing between live and remaining featured items, and providing a reorder link. Flash messages are now handled by a shared FlashMessageComponent with an html\_safe option, ensuring consistent rendering and tracking for success and error alerts.

app/components/admin · high confidence

Admin author contact details page now displays email

The admin view for individual authors has been updated to explicitly show the author's email address via a mailto link. The page title and heading now reflect that this is a contact details view, and the layout uses the standard grid system to present the information.

app/views/admin/authors · high confidence

Admin controllers migrated to GOV.UK Design System layout

The admin interface now uses the GOV.UK Design System layout by default for all controllers under app/controllers/admin. This is achieved by setting the layout to 'design\_system' in the new Admin::BaseController, which all admin controllers now inherit. The change ensures a consistent visual style and user experience across the administration area, replacing the previous Bootstrap-based layouts.

app/controllers/admin · high confidence

Admin interface styling migrated to GOV.UK Design System

The admin interface's visual presentation has been updated to align with the GOV.UK Design System. This change introduces new, targeted SCSS styles for key administrative views—including the dashboard, edition management, document collections, and various index pages (organisations, people, roles, topical events)—replacing legacy global classes with component-specific styling. Users will see consistent spacing, typography, and table layouts across these admin sections, along with improved visual cues for audit trail comparisons and form elements.

app/assets/stylesheets/admin/views · high confidence

Admin interface styling overrides for tables, forms, and read-only views

A new overrides stylesheet introduces specific visual and behavioral adjustments to the admin interface. Tables with actions now align their action buttons to the right, and filterable tables use a fixed layout. Small tags are styled with increased font weight, and code elements are displayed in red. Translation input and textarea components have adjusted margins, while summary lists with images now vertically align their keys. Additionally, when JavaScript is enabled, the 'Remove' checkbox for 'Add another' fields is hidden to prevent empty field submissions, and the 'reorder attachments' list becomes non-interactive in read-only mode.

app/assets/stylesheets/admin · high confidence

The admin interface now supports managing featured links with a new 'Add another' component that allows users to dynamically add, edit, and delete link entries, including support for translated inputs when editing non-default locales. A notice has been added to clearly indicate when an edition is in a read-only state, guiding users to create a new edition to make changes. Additionally, the search results for featurable editions now include specific data attributes to support GA4 tracking for list titles and start indices.

app/views/admin/shared · high confidence

Admin maintenance mode and authenticated user header support

The application now supports a maintenance mode that displays a specific error page when enabled, and ensures the authenticated user's ID is propagated via the x\_govuk\_authenticated\_user header for analytics and tracking. Additionally, a new controller allows signed-in users to request document list exports, which are then retrieved from S3.

app/controllers · high confidence

Admin social media accounts index uses GOV.UK Design System summary cards with permission checks

The social media accounts index page now renders account details using a new SummaryCard component styled with the GOV.UK Design System. This component displays account titles and URLs for each supported locale and provides action links (View, Edit, Delete) that are strictly gated by the current user's permissions, ensuring that users without update or delete rights cannot access those actions.

_app/components/admin/social\_media\accounts · high confidence

Adopts GOV.UK Publishing Components for pagination

The pagination view now renders using the \govuk\_publishing\_components\ pagination component instead of the previous Kaminari default. This change ensures that pagination links retain query string parameters and supports passing an anchor tag to the URL, providing a consistent user experience aligned with GOV.UK design standards.

_app/views/kaminari/govuk\paginator · high confidence

Automatic cleanup of organization associations during news story subtype conversions

A new \StandardEdition::HygieneEnforcer\ class is introduced to automatically resolve data inconsistencies that occur when converting between news story subtypes and world news stories. Previously, converting to or from a world news story could leave redundant associations (such as standard \organisations\ on a world news story or \worldwide\_organisations\ on other subtypes) in the database and Publishing API, causing incorrect data to surface on the frontend. This service now runs after every document conversion to detect these 'dirty' states, remove the redundant associations from the database, and patch the Publishing API links to ensure the correct organization data is displayed.

_app/services/standard\edition · high confidence

Custom slug normalization using Babosa

The application now uses a custom normalization module for FriendlyId slugs that leverages the Babosa gem. This change improves string parameterization by applying Babosa's normalize method to slugs, ensuring more consistent and readable URL slugs for users.

_lib/friendly\id · high confidence

Database schema migration for worldwide organisations and content blocks

This update applies a series of database migrations that restructure how worldwide organisations and content blocks are stored. Worldwide organisations are migrated to an edition-based model, involving the creation of new tables like \editionable\_worldwide\_organisations\ and \worldwide\_organisation\_pages\, while legacy tables such as \worldwide\_organisations\ and \sponsorships\ are dropped. Content blocks are introduced with new tables for documents, editions, and authors, alongside indexes to support these new relationships. Additionally, the schema is cleaned up by removing unused columns and tables, such as \financial\_reports\ and \specialist\_sectors\, and adding support for features like visual editors and republishing events.

db/migrate · high confidence

Database schema updated to Rails 8.1 with new access-limiting and attachment models

The database schema has been regenerated for Rails 8.1, introducing tables to support granular access control and enhanced attachment management. New \access\_limiting\_individuals\ and \access\_limiting\_organisations\ tables allow editions to be restricted to specific users or organisations, while the \attachments\ table now includes fields for \accessible\ status, \content\_id\, and \safely\_resluggable\ to improve asset handling. The seed data has also been updated to create a minimal test environment, including a test user with specific permissions and sample organisations, governments, and world locations.

db · high confidence

Display read-only email notification settings for document collections

The document collection admin interface now shows a dedicated page for email notification settings. Instead of allowing users to edit these settings, the view informs them that notifications cannot be changed and explains that subscribers receive alerts for major content changes and when the page is unpublished. This replaces the previous UI that allowed adding email alerts, shifting the capability to a read-only informational display.

_app/views/admin/document\_collection\_email\subscriptions · high confidence

Document collection form migrated to GOV.UK Design System

The document collection creation and editing interface has been updated to use the GOV.UK Design System. The form now renders associations (organisations and topical events) within a styled fieldset component, replacing the previous legacy form structure to provide a consistent and accessible user experience.

_app/views/admin/document\collections · high confidence

Edition model refactored into modular concerns

The Edition model has been restructured by extracting its responsibilities into a set of focused concerns (such as LimitedAccess, Organisations, Workflow, and Identifiable). This change introduces a new, config-driven access limiting system that replaces the legacy access\_limited column, allowing users to restrict content by specific organisations or individuals with robust validation. It also standardizes how editions handle associations, publishing workflows, and slug generation, ensuring consistent behavior across different document types.

app/models/concerns/edition · high confidence

Extract embed code replacement logic into dedicated service

The logic for finding and replacing embed codes within content blocks has been moved out of the Content Block Manager engine into a new, standalone service (FindAndReplaceEmbedCodesService). This service now handles fetching content items from the Publishing API using content ID aliases and rendering the corresponding blocks, providing a clearer separation of concerns for this specific functionality.

_app/services/content\block · high confidence

Government management interface migrated to GOVUK Design System

The admin interface for creating, editing, listing, and closing governments has been rebuilt using the GOVUK Publishing Components library. This update introduces a consistent design system across the government modelling pages, including a new form for setting start and end dates, a table-based index view, and a dedicated 'prepare to close' workflow that lists active ministerial appointments before unappointing them. The changes also enforce GDS admin permissions for these actions and ensure the UI handles blank dates and current-government states correctly.

app/views/admin/governments · high confidence

Introduces custom Whitehall decorator infrastructure to replace Draper

The application now uses a new, internal decorator framework located in lib/whitehall/decorators, replacing the previous Draper-based implementation. This change introduces a base Decorator class and a specialized CollectionDecorator for handling lists of items, along with a configurable DelegateInstanceMethodsOf helper to manage method delegation. For users, this means the underlying presentation layer for models and collections has been refactored to be more lightweight and configurable, though the external API for decorating objects remains consistent.

lib/whitehall/decorators · high confidence

Migrate admin stylesheets to SCSS and introduce new design system components

The admin interface's styling architecture has shifted from a single CSS manifest file to a modular SCSS structure. The legacy \application.css\ manifest has been removed and replaced with \application.scss\, which explicitly imports the GOV.UK Publishing Components library, specific new design system components (such as the image cropper, miller columns, and secondary navigation), and scoped styles for various admin views including people, organisations, and worldwide offices. This change introduces specific styling for new components like the worldwide offices summary card and implements a JavaScript-enabled class strategy to prevent flash of unstyled content during module initialization.

app/assets/stylesheets · high confidence

Migrate asset precompile configuration to manifest file

The asset pipeline configuration has been updated to use a new \manifest.js\ file, which explicitly defines the precompiled assets including \application.js\, \test-dependencies.js\, \admin/domain-config.js\, and \es6-components.js\, alongside image and build directories. This change replaces the previous implicit or alternative configuration method, ensuring that the frontend JavaScript bundles and specific admin configurations are correctly linked during asset precompilation.

app/assets/config · high confidence

Migration to GOV.UK Notify for email delivery

The application has switched its email infrastructure from Amazon SES to the GOV.UK Notify service. This change introduces a new base mailer class that integrates with the Notify API using template IDs, replacing the previous ActionMailer implementation. Existing notification types such as fact-check requests, edition publication alerts, and consultation deadlines are now routed through this new system, ensuring consistent delivery via the government's central notification platform.

app/mailers · high confidence

Nation inapplicability list now conditionally renders alternative URLs

The partial rendering the list of nations where a policy or consultation does not apply has been updated to only display a clickable link when an alternative URL is available. If no alternative URL exists, the nation name is shown as plain text, and the link element is omitted entirely.

_app/views/nation\inapplicabilities · high confidence

New GOV.UK Design System interface for editing statistics announcement tags

Administrators can now use a redesigned, GOV.UK Design System-based interface to edit the topic taxonomy tags for a statistics announcement. The new edit view replaces the previous implementation, featuring a dedicated section for selected topics and a taxonomy group selector, streamlining the tagging workflow.

_app/views/admin/statistics\_announcement\tags · high confidence

New GOV.UK Design System interface for managing organisation translations

Administrators can now view, create, edit, and delete translations for organisations using a redesigned interface built with the GOV.UK Design System. The new index page lists existing translations with actions to view, edit, or delete them, and provides a selector to add new translations. The edit page allows updating the name, acronym, and logo-formatted name for each language, while a dedicated confirmation page ensures users verify deletions before they are processed.

_app/views/admin/organisation\translations · high confidence

New JavaScript modules for admin form interactions and reports

This change introduces four new JavaScript modules in the admin interface to handle specific form behaviors and report generation. The EditionForm module manages dynamic UI updates for speech editions, including showing/hiding location fields based on speech type, displaying warnings for future delivery dates, and revealing URL override options when titles change. The OrganisationForm module controls the visibility of custom logo and non-departmental public body fields based on selection changes. The UnpublishDisplayConditions module handles the conditional display of sections in the unpublish/withdraw form based on the selected reason, including the new 'Archived' option. Finally, the BrokenLinksReport module enables automatic generation and polling of broken links reports via AJAX, replacing the previous manual refresh mechanism and integrating with GA4 analytics.

app/assets/javascripts/admin/views · high confidence

New Sidekiq job infrastructure and asset access limiting

The \app/sidekiq\ directory has been restructured with a new \JobBase\ class and a comprehensive suite of dedicated background jobs for asset management, publishing API interactions, and content maintenance. Key additions include \AssetManagerCreateAssetJob\, which now enforces individual and organizational access limiting on uploaded assets, and \AssetManagerAttachmentMetadataJob\, which safely handles asset replacement lookups only for models that support it. The system also introduces jobs for bulk republishing (\PublishingApiDocumentRepublishingJob\), link checking (\RevalidateLinkCheckReportJob\), and content updates (\FindAndReplaceJob\), while removing the legacy \StandardEditionMigrator\ implementation in favor of a new \StandardEditionMigratorJob\.

app/sidekiq · high confidence

New Topic Taxonomy tagging interface

The admin tagging interface now uses a dedicated 'Topic taxonomy tags' view for managing edition tags. This change replaces the previous tagging UI with a form that renders a shared taxonomy group description and selector, displays selected topics under a clear heading, and provides 'Save' and 'Cancel' actions, aligning the tagging workflow with the new topic taxonomy structure.

_app/views/admin/edition\tags · high confidence

New UI for featuring and unfeaturing items

The admin interface for managing featured content has been updated with new views for the 'new' and 'confirm unfeature' actions. Users can now feature items using a form that includes a file upload for images and an alt text field, with conditional warning messages displayed for non-editionable features and non-organisation parents. Additionally, a dedicated confirmation page allows users to verify the removal of a feature before it is unfeatured.

app/views/admin/features · high confidence

New ViewComponents for edition history, fact-checking, and document type changes

The edition editing interface now uses dedicated ViewComponents to render key sections. The Document History tab is encapsulated in DocumentHistoryTabComponent, which supports filtering (internal notes vs. history) and pagination, and renders specific entry types: AuditTrailEntryComponent for standard actions, EditorialRemarkComponent for internal notes (now supporting links), and HostContentUpdateEventComponent for content block updates. A new FactCheckingTabComponent displays pending and completed fact-check requests and provides a form to send new requests. Additionally, DocumentTypeChangeSummaryComponent visualizes field differences when changing a document's type, and the TagsComponent now surfaces 'Force scheduled' and 'Dangerous links' statuses.

app/components/admin/editions · high confidence

New ViewComponents for edition preview, sidebar actions, and translations

The edition show page now uses dedicated ViewComponents to structure the preview, sidebar actions, and translations sections. The PreviewComponent displays preview links with cache-busting, supports sharing via expiring auth-bypass tokens, and warns users if the edition is invalid. The SidebarActionsComponent consolidates all workflow buttons (create, edit, submit, schedule, publish, reject, delete, etc.) into a single list, applying GA4 tracking data attributes and preventing multiple form submissions. The TranslationsComponent lists non-primary translations with edit/delete actions where permitted.

app/components/admin/editions/show · high confidence

New admin filter classes for editions and statistics announcements

The admin interface now uses dedicated filter classes (\Admin::EditionFilter\ and \Admin::StatisticsAnnouncementFilter\) to manage document listing and statistics announcement views. For general editions, the new filter supports filtering by type, state, author, organisation, date range, and specific flags like broken links or overdue reviews, while enforcing a maximum export size of 8,000 records to prevent memory issues. For statistics announcements, the filter allows filtering by title, organisation, and link status (unlinked only), with specific date scopes for past, future, and imminent (two-week) releases, and orders results by the current release date.

app/models/admin · high confidence

New admin forms and page diff views for Worldwide Organisations

The admin interface for Worldwide Organisations now uses new GOV.UK Design System components. The edit form (\_form.html.erb) allows administrators to update the logo formatted name, upload a default news image, and manage associations such as the main office, world locations, roles, and related organisations. Additionally, a new diff view (\_pages\_diff.html.erb) displays side-by-side comparisons of page summaries and bodies for audit trails, helping users track changes to corporate information pages.

_app/views/admin/worldwide\organisations · high confidence

New cabinet ministers ordering interface with reshuffle preview

The cabinet ministers administration page has been redesigned using the GOV.UK Design System, introducing a tabbed interface for reordering cabinet ministers, also-attends-cabinet roles, whips, and ministerial organisations. Each section now features a dedicated reorder form with drag-and-drop or button-based reordering capabilities. Additionally, during a reshuffle, a preview link is provided to view the ministers page on the website.

_app/views/admin/cabinet\ministers · high confidence

New controller concerns for document types, permissions, translations, and historic content

This change introduces four new controller concerns in the application: DocumentTypesConcern defines the available document types and their creation rules, including feature flags and parent-child relationships; HistoricContentConcern prevents editing or unpublishing of documents in history mode with a specific user-facing error message; PermissionsCheckerConcern provides a unified can? method for checking user permissions via the Whitehall authority enforcer; and TranslationControllerConcern handles the lifecycle of translations including creation, updating, and deletion, with integration to the publishing API.

app/controllers/concerns · high confidence

New custom error pages for the Whitehall admin interface

The admin interface now displays custom-designed error pages for common HTTP status codes (400, 401, 403, 404, 422, 500) and maintenance downtime, replacing previous static or default responses. These pages follow the GOV.UK design system and provide specific guidance to users, such as links to raise support tickets for server errors, instructions to check URLs for 404s, and administrative options to update access permissions when encountering a 403 Forbidden error.

app/views/admin/errors · high confidence

New document creation page with GDS approval section

The new document creation interface has been updated to separate document types that require GDS approval into their own section, complete with a hint and link to submit a support request. The page now supports creating child documents by displaying a 'Child Of' banner and passing the parent edition ID through the form. Additionally, a guidance link to the content types page is included to help users choose the correct document type.

_app/views/admin/new\document · high confidence

The admin features interface now uses a new \FeaturedDocumentsTableComponent\ to display featured items. This component renders a table showing the title, type, and published date for each feature, addressing the need to provide publishers with published date information. It supports a read-only mode, which hides the edit and unfeature action links, and correctly distinguishes between new document features, legacy topical events, and offsite links when determining the display type and generating appropriate edit links.

app/components/admin/features · high confidence

New paginated document timeline with edition filtering and event inclusion

A new \Document::PaginatedTimeline\ class has been introduced to replace the previous history mechanism, providing a paginated view of document activity (10 items per page). This timeline now supports filtering by specific event types via an \only\ parameter and includes host content update events alongside version and remark entries. It also provides helper methods to group timeline entries by their relationship to the current, previous, or newer editions of a document.

app/models/document · high confidence

New publication type selection with grouped options and format guidance

Admins can now select a publication type from a grouped 'select with search' dropdown (Common types, Less common types, Use discouraged) and will see dynamic format advice based on the selected type. The form also includes a dedicated Associations section for linking to appointments, statistical data sets, topical events, world locations, organisations, and nations.

app/views/admin/publications · high confidence

Admin users can now view search results for featured editions in a structured table format. The new \\_search\_results.html.erb\ partial displays edition title, type, and major change published date, along with specific actions for each item, replacing the previous display method. Pagination is included to handle large result sets, and a result count is shown at the top.

_app/views/admin/featurable\editions · high confidence

New storage classes for attachment and default asset handling

Two new storage implementations, \AttachmentStorage\ and \DefaultStorage\, have been introduced to handle asset uploads with distinct requirements. \AttachmentStorage\ is designed for attachment assets and includes specific logic to pass model context (such as \attachable\ class and ID) to the asset creation job, while \DefaultStorage\ provides a standard upload path for other assets. Both classes delegate temporary file storage to \TempStorage\ and asynchronously create assets via \AssetManagerCreateAssetJob\, ensuring that different asset types are processed according to their specific data needs.

app/uploaders/storage · high confidence

New summary list component for organisation details

The organisation show page now uses a dedicated summary list component to display key details such as name, acronym, logo settings, brand colour, default news image, URL, type, status, and associated organisations. The default news image row includes a 'Processing' label when asset variants are not yet uploaded, providing clearer feedback on image status.

app/components/admin/organisations · high confidence

New validation layer for attachments, URLs, and content safety

A comprehensive set of new validators has been introduced to enforce stricter data integrity and security rules across the publishing workflow. The new AttachmentValidator ensures House of Commons and Command Paper numbers follow correct formats and are mutually exclusive based on paper type. URL handling is now governed by dedicated validators: GovUkUrlValidator checks that internal links point to valid GOV.UK pages, GovUkUrlFormatValidator restricts external redirects to a specific allowlist (including .police.uk and judiciary.uk), and UriValidator enforces a 255-character limit and protocol checks. Content safety is improved via SafeHtmlValidator, which uses a memory cache to efficiently check Govspeak for unsafe HTML/XSS, and NoFootnotesInGovspeakValidator, which prevents footnotes in specific document types. Additional validators enforce that editions are tagged with a Taxon, that social media links are unique and valid, that embedded contacts exist, and that internal admin links in Govspeak are correctly formatted. Finally, the UnmodifiableValidator prevents changes to specific fields once an edition reaches certain states, and the SchemaValidator ensures consistency between document schemas and form definitions.

app/validators · high confidence

People administration views migrated to GOV.UK Design System

The admin interface for managing people (including ministers and privy counsellors) has been rewritten using GOV.UK Design System components. This update introduces new views for listing, creating, editing, and deleting people, featuring a summary list for person details, a dedicated reorderable list for role appointments, and a confirmation dialog for deletions. The form now supports specific fields such as the 'Rt Hon' prefix, title, forename, surname, letters, and biography, alongside image uploads. Warning messages are displayed to guide users on creating ministerial entries and the immediate impact of changes on the live site.

app/views/admin/people · high confidence

Rails 8 upgrade and configuration modernization

The application has been upgraded to Rails 8, bringing several configuration and behavioral changes. Session cookies are now secure by default in non-development/test environments, controllable via the DISABLE\_SECURE\_COOKIES environment variable. The cookie serializer has switched from the default to JSON for improved security and compatibility. Asset compilation now uses Dart Sass with specific build options, and Yarn node\_modules are included in the asset load path. CarrierWave storage is configured to use a default storage engine with a configurable uploads root and cache directory. New inflection rules preserve acronyms like NHS, FOI, and BSL, and handle specific pluralizations. Date and time formats have been standardized to UK conventions. The application now supports a wider range of file attachments via new MIME types (e.g., RDF, DXF, GML, SVG, OpenDocument formats). Error handling has been updated to exclude specific Redis and database errors from Sentry reporting. The publishing API client now uses bearer token authentication. Additionally, the application now supports auto-reloading of configurable document type schemas in development, and uses inline SVG with strict file-not-found raising.

config/initializers · high confidence

Rails 8.1 upgrade and configuration overhaul

The application has been upgraded to Rails 8.1, bringing new default behaviors for Active Record callbacks and CSRF protection. The database configuration has been migrated from SQLite to MySQL with UTF8MB4 encoding, and the boot process now uses Bootsnap for improved performance. New configuration files have been introduced to manage feature flags (Flipflop), Sidekiq background job queues, and address formatting for international locales.

config · high confidence

Redesign document collection group management with GOV.UK Design System

The document collection group interface has been rebuilt using the GOV.UK Design System, replacing the previous tab-based layout with a structured set of pages for listing, creating, editing, and deleting groups. Users can now manage groups via a summary card list, add new groups with a dedicated form, and reorder groups using a drag-and-drop interface. The update also introduces a confirmation step before deleting a group and adds a back-link for easier navigation.

_app/views/admin/document\_collection\groups · high confidence

Redesign edition workflow confirmation pages using the GOV.UK Design System

The admin interface for edition workflow actions—specifically publishing, force publishing, force scheduling, unscheduling, unpublishing, withdrawing, unwithdrawing, and retrospective approval—has been updated to use the GOV.UK Design System. These new confirmation pages replace previous implementations with a consistent layout, including destructive styling for high-impact actions, integrated error summaries, and standardized form components. The unpublishing workflow now explicitly supports 'Withdrawn' and 'Archived' reasons, allows reusing previous withdrawal dates, and provides a govspeak editor for public explanations, ensuring the UI aligns with current government publishing standards.

_app/views/admin/edition\workflow · high confidence

Redesign fact-checking interface with GOV.UK Design System

The fact-checking workflow for administrators has been redesigned to use the GOV.UK Design System, replacing the previous HAML templates with new ERB views. The edit page now presents the document and its attachments in tabs, includes explicit instructions for fact-checkers, and provides a dedicated textarea for submitting comments. The show page displays the submitted response alongside the original document and attachments, while a new template handles cases where the document is unavailable. This change updates the user experience for managing fact-check requests, ensuring consistent styling and clearer guidance throughout the process.

_app/views/admin/promotional\features · high confidence

Redesign of Topical Events admin interface

The admin interface for managing Topical Events has been updated to use the GOV.UK Design System. The new views include a redesigned form for creating and editing events, featuring structured date inputs for start and end dates, a dedicated logo upload component, and an 'add another' interface for social media accounts. The index page now displays a filterable table of events, and a new confirmation page has been added for the delete action, improving the overall consistency and usability of the administrative tools.

_app/views/admin/topical\events · high confidence

Redesign of sitewide settings pages using GOVUK Design System

The sitewide settings index and edit pages have been updated to use the GOVUK Design System components. The index page now displays settings in a styled table with an empty-state message when no settings are configured, while the edit page presents a form for enabling re-shuffle mode and editing Govspeak content, including a warning that changes appear instantly on the live site.

_app/views/admin/sitewide\settings · high confidence

Redesign of the Call for Evidence creation form

The admin interface for creating a Call for Evidence has been updated to use the GOV.UK design system. The form now includes specific guidance on when to use this format versus consultations, and provides structured fields for participation details (link, email, postal address) and downloadable response forms. Date inputs for opening and closing times have been migrated to a new component-based structure, and association fields (appointments, organisations, etc.) are now rendered via extracted partials for consistency.

_app/views/admin/calls\_for\evidence · high confidence

Redesign of the admin edition edit form with GOV.UK Design System components

The admin interface for editing editions has been rebuilt using GOV.UK Design System components, replacing the previous layout. This change introduces a structured form with dedicated sections for Content (title, summary, body), Settings (access limiting, scheduled publication, review reminders), and Associations (organisations, roles, world locations). The update also includes a new filter interface for the editions index page, improved handling of right-to-left languages, and clearer change note guidance to help editors communicate updates to users.

app/views/admin/editions · high confidence

Redesign of the speech editing form with new speaker and date fields

The admin interface for editing speeches has been updated to use the GOV.UK Design System, introducing dedicated partials for speaker selection, delivery date, and location. Users can now specify whether a speaker (or writer, for authored articles) has a GOV.UK profile, selecting from a searchable list or providing a manual override. The 'Delivered on' date input now includes a dynamic warning if a future date is selected, and a new 'Location' field has been added to speech metadata. The form also consolidates association fields (topical events, world locations, organisations) and speech type selection into a structured layout.

app/views/admin/speeches · high confidence

Redesign organisation administration interface with GOV.UK Design System

The organisation administration views have been rebuilt using the GOV.UK Design System, replacing the previous layout with a consistent, accessible interface. This update introduces a new organisation creation and editing form that includes fields for name, acronym, logo, brand colour, and type, along with a dedicated section for managing closed organisations (reason, superseding organisations, and closure date). The index page now features a filterable table for listing organisations, while the show and features pages utilize a secondary navigation structure to organize content such as featured documents, topical events, and external links. A new confirmation page has been added for safely deleting organisations.

app/views/admin/organisations · high confidence

Redesign policy group management pages using GOV.UK Design System

The admin interface for managing policy groups has been rebuilt to use GOV.UK Design System components. This update introduces a new index page listing groups with filterable table actions, a redesigned form for creating and editing groups with explicit field labels and error handling, and a dedicated confirmation page for deleting groups. The new pages also include a 'View on website' link in the edit view and warning text advising users to consult GDS before creating groups.

_app/views/admin/policy\groups · high confidence

Redesign role appointment management with GDS Design System

The role appointment admin interface has been rebuilt using the GDS Design System components, replacing the previous UI. The new edit and create forms use a searchable person selector and standardized date pickers for start and end dates. A key behavioral change is that the person assigned to an appointment cannot be edited after the record is created, with an explanatory note provided to users to preserve speech associations. The edit page now displays a list of speeches given during the appointment and other appointments to the same role, while the list view filters out non-persisted records.

_app/views/admin/role\appointments · high confidence

Redesign role translation management with GOV.UK Design System

The role translation interface has been updated to use the GOV.UK Design System, providing a consistent look and feel for administrators. The index page now displays a table of existing translations with edit and delete actions, and allows users to create new translations via a language selector. The edit page uses specialized input components to handle name and responsibilities fields, including support for right-to-left languages and a Govspeak editor for responsibilities. A new confirmation step has been added before deleting a translation to prevent accidental data loss.

_app/views/admin/person\_translations, app/views/admin/role\translations · high confidence

Redesign statistics announcement admin interface to GOV.UK Design System

The statistics announcement administration views have been rebuilt using the GOV.UK Design System components, replacing the previous layout and styling. This update introduces a new index page with enhanced filtering capabilities (by title, organisation, release date, and unlinked status) and search result tracking via GA4 data attributes. The new interface includes dedicated pages for creating, editing, and viewing announcements, as well as new workflows for cancelling announcements and editing cancellation reasons. Form elements such as date inputs, organisation selectors, and radio buttons have been standardized to the new design system, improving consistency and accessibility across the admin tool.

_app/views/admin/statistics\announcements · high confidence

Redesigned HTML and External attachment forms with read-only support

The admin interface for managing HTML and External attachments has been restructured into dedicated view templates. HTML attachment editing now includes a dedicated form for GoVSpeak content, featuring a checkbox to enable manually numbered headings and a preview link that appends a cache-busting parameter to ensure users see the latest published version. External attachments now have their own specific form for entering URLs. Both attachment types support a read-only mode, which disables editing and provides a back link to the parent edition's attachment list.

_app/views/admin/html\attachments · high confidence

Redesigned admin contacts interface with new design system and features

The admin contacts pages have been rebuilt using the GOV.UK design system, replacing the previous layout with structured forms and summary cards. Users can now create and edit contacts with a dedicated contact type selector, structured address fields, and the ability to add multiple phone numbers via an 'add another' interface. The interface supports managing translations for contacts, including adding and deleting them, and allows administrators to reorder contacts displayed on an organisation's homepage. A new confirmation step has been added for deleting contacts to prevent accidental removal.

app/views/admin/contacts · high confidence

The admin dashboard has been rebuilt using the GOV.UK Design System, replacing the previous layout with a structured grid of quick links for Writing and publishing, Product development, and Support. The page now includes a dedicated section for 'My draft documents' and, for users in an organisation, a section for 'force-published documents', both rendered via a new shared document table component that displays title, type, last updated time, and action links.

app/views/admin/dashboard · high confidence

Redesigned admin interface for creating and editing consultation responses

The admin views for consultation responses have been rewritten to use the new GOV.UK Publishing Components framework. The edit and show pages now utilize the \datetime\_fields\ component for publishing dates and the \govspeak\_editor\ component for summaries, replacing previous custom implementations. The layout has been updated to use the standard grid system, and the show page now displays a summary list with an edit link, alongside an optional attachments section that reuses the common \attachment\_fields\ partial. This change standardizes the user experience for managing consultation responses within the admin interface.

_app/views/admin/consultation\responses · high confidence

Redesigned attachment management interface with bulk upload and reordering

The admin attachment management experience has been overhauled to support bulk file uploads, explicit attachment ordering, and a unified design system. Users can now upload multiple files simultaneously via a new upload interface that includes guidance on open standards formats and handles filename conflicts (keep, replace, or reject). A dedicated reorder page allows users to arrange attachments using drag-and-drop or up/down buttons, with the option to view this in a read-only mode. The attachment list view now displays processing status tags, provides copy-to-clipboard buttons for inline markdown links, and uses consistent GOV.UK component styling for actions like editing and deleting.

app/views/admin/attachments · high confidence

Redesigned call for evidence response editing and viewing interface

The admin interface for managing call for evidence responses has been updated to use the current design system. The edit form now uses a dedicated \datetime\_fields\ component for the 'Published on' date, ensuring consistent styling and accessibility. The view page has been restructured to display a summary list of the response details (summary and publication date) with an edit link, alongside an optional attachments section. A new back link has been added to allow users to easily return to the main edition page from both the edit and show views.

_app/views/admin/call\_for\_evidence\responses · high confidence

Redesigned contact information display with new partial

The contact information section has been updated to use a new \\_contact.html.erb\ partial, which renders contact details using GOV.UK Frontend styling (e.g., \govuk-body\, \govuk-link\). This change introduces several behavioral updates: contact comments are now automatically linked if they contain URLs, access and opening times links for Worldwide Offices are now translatable and include language attributes, and the display logic for postal addresses, emails, contact forms, and phone numbers has been consolidated into a cleaner structure. The partial also supports hiding titles via a local variable and ensures proper HTML escaping and formatting for comments.

app/views/contacts · high confidence

Redesigned detailed guide editing form with GOV.UK Design System

The editing interface for detailed guides has been rebuilt using the GOV.UK Design System components, replacing the previous legacy form structure. This change introduces a new layout for the 'Associations' section, which now includes dedicated fields for organisations, topical events, nations, and a multi-select search component for linking related detailed guides. Additionally, the 'Related mainstream content' section has been updated to use standard input components for URL fields, improving consistency and usability for administrators managing these content types.

_app/views/admin/detailed\guides · high confidence

Redesigned edition summary page with new sidebar and structured sections

The edition show view has been restructured into a main content area and a sidebar. The main area now uses a summary list to display key metadata (document type, status, change type, organisations, access, review date, language) and includes dedicated sections for the parent edition, public change notes, topic taxonomy tags, worldwide tags, images, and attachments. The sidebar provides action buttons, validation error prompts, link check reports, and tabs for document history and fact checking. This change reorganizes the user interface to present edition details and actions in a more structured, component-based layout.

app/views/admin/editions/show · high confidence

Redesigned image management interface with upload validation and processing feedback

The admin image management UI has been refactored to provide clearer guidance and better feedback during image uploads. The new upload form now displays specific dimension requirements and restricts SVG uploads for lead images, while also showing inline error messages for failed uploads. Image cards now indicate processing status with a 'Processing' tag for newly uploaded images and a 'Requires cropping' tag for images needing attention. The lead image card has been updated to include a 'Use default image' option when no custom image is set, and the interface now hides caption fields when captions are disabled for the specific image usage.

_app/components/admin/edition\images · high confidence

The admin interface for creating, editing, and deleting offsite links has been rebuilt using GOV.UK Design System components. The new UI includes dedicated views for adding and modifying external links, featuring structured input fields for title, summary, link type, and date, along with validation for permitted host domains. A confirmation step is now required before deleting a link, and the interface supports managing these links across various parent entities such as organisations, world locations, and topical events.

_app/views/admin/offsite\links · high confidence

Redesigned social media account management interface

The social media accounts section for organisations and worldwide organisations has been rebuilt using the GOV.UK Design System. Administrators can now create, edit, and delete social media accounts through dedicated pages that include a confirmation step for deletion. The interface supports adding optional titles to accounts and allows editing in multiple languages. The layout uses standard GOV.UK components for forms, navigation, and error handling, replacing the previous implementation.

_app/views/admin/social\_media\accounts · high confidence

Redesigned statistics announcement date change form using GOV.UK Design System

The interface for changing the release date of a statistics announcement has been rebuilt to use the GOV.UK publishing components and Design System. Users now interact with a structured date-time picker for the release date and radio buttons to select the precision level (exact date or within one/two months), with options clearly marked as provisional or confirmed. The form dynamically enforces a public change note when a confirmed exact date is selected, provides an inset text warning to also update any attached publication's release date, and retains user input on validation errors to improve the editing experience.

_app/views/admin/statistics\_announcement\_date\changes · high confidence

Redesigned statistics announcement summary page

The statistics announcement show page has been rebuilt using the GOV.UK design system components, replacing the previous layout with a structured summary view. Users now see a dedicated main section displaying the announcement summary, type, associated organisations, and release/delivery dates (including cancellation status), alongside a sidebar with action buttons for updating, cancelling, or unpublishing the announcement. The page also features a new history list and improved navigation for connected documents and topic taxonomy tags, ensuring consistent styling and usability across the admin interface.

_app/views/admin/statistics\announcements/show · high confidence

Redesigned translation workflow with new views and confirmation

The edition translation interface has been updated to use new, design-system-compliant views for creating, editing, and deleting translations. Writers now encounter a dedicated 'Add translation' page to select a language, a redesigned 'Edit translation' form that displays the original English text alongside translatable fields (title, summary, body) and supports right-to-left locales, and a new 'Confirm delete' page for removing translations. The edit view also integrates tabs for GoVSpeak help, document history, and fact-checking status where applicable.

_app/views/admin/edition\translations · high confidence

Redesigned unpublishing edit page with GOV.UK Design System and redirect options

The edit page for edition unpublishing has been rebuilt using the GOV.UK Design System, featuring a new layout and an error summary component. Users can now edit the public explanation via a dedicated Govspeak editor that supports pasting HTML and handling images/attachments. For non-withdrawn unpublishings, a new 'Alternative URL' field allows setting a redirect target, and a specific checkbox enables automatic redirection to that URL when the unpublishing reason is 'Published in Error'. The interface also includes a cancel link with a no-visited-state style.

_app/views/admin/edition\unpublishing · high confidence

Redesigned user administration interface with new views and components

The admin user management interface has been updated to use the GOV.UK Design System, replacing legacy templates with new index, show, and edit views. The index page now displays a filterable table of users showing their name, role, and organisation. The show page presents user details in a summary list format, including name, email, role, organisation, and world locations. The edit page allows administrators to update a user's world locations using a 'select with search' component. These changes modernize the UI and improve consistency across the admin section.

app/views/admin/users · high confidence

Redesigned world location news translation management interface

The admin interface for managing translations of world location news has been updated to use the GOV.UK Design System, replacing the previous styling. This change introduces a new index page that lists existing translations with view, edit, and delete actions, alongside a form to create new translations. The edit page now features a redesigned form for updating translation names, titles, and mission statements, including support for right-to-left languages. Additionally, a dedicated confirmation page has been added for the delete action, ensuring users explicitly confirm before removing a translation.

_app/views/admin/world\_location\_news\translations · high confidence

Refactor Publishing API payload builders into modular components

The logic for constructing Publishing API payloads has been extracted from presenters into dedicated, reusable PayloadBuilder classes (e.g., \AccessLimitation\, \ConfigurableDocumentLinks\, \Routes\, \TopicalEvents\). This change standardizes how specific data sections—such as access restrictions, document links, and routing information—are generated, ensuring consistent handling of edge cases like blank access-limiting arrays and duplicate topical event IDs while removing legacy branching logic.

_app/presenters/publishing\_api/payload\builder · high confidence

Refactor image and document uploaders to use Carrierwave and AssetManager storage

The uploaders in app/uploaders have been rewritten to use Carrierwave instead of the previous implementation, integrating with AssetManager for storage. ImageUploader and FeaturedImageUploader now support dynamic versioning and dimension validation based on image kind configuration, while LogoUploader and ResponseDocumentUploader are simplified to handle specific file types. The base WhitehallUploader provides common storage path logic and asset parameter generation, ensuring consistent handling of image variants and document attachments across the application.

app/uploaders · high confidence

Refactor organisation type logic into a dedicated concern

The validation rules, query scopes, and helper methods for organisation types have been moved from the main Organisation model into a new \Organisation::OrganisationTypeConcern\. This change extracts specific logic—such as filtering for ministerial departments, HMCTS tribunals, and courts, as well as the \supporting\_bodies\ method—into a reusable module, improving code organization without altering the external API of the Organisation model.

app/models/concerns/organisation · high confidence

Refactor taxonomy tagging UI into shared partials

The taxonomy tagging interface in the admin area has been refactored by extracting the description and selector components into shared partials. The description partial now provides user guidance on using the topic taxonomy, including links to external guidance and forms for suggesting new or changed tags. The selector partial renders the miller columns component for choosing taxons and includes a notice explaining that topic changes are applied to live pages immediately upon updating tags, even before publishing a new edition.

app/views/admin/shared/tagging · high confidence

Refactored asset management into dedicated updater, deleter, and attachment services

The asset management logic has been restructured into distinct service classes: \AssetManager::AssetUpdater\, \AssetManager::AssetDeleter\, and \AssetManager::AttachmentUpdater\, supported by a new \ServiceHelper\. This change introduces specific error handling for empty attributes and deleted live assets, ensures attachment updates correctly handle access limitations and replacement IDs, and prevents updates to assets that have been deleted, thereby improving reliability during publishing workflows.

_app/services/asset\manager · high confidence

Refactored attachment form UI with read-only support and new reference fields

The attachment editing interface has been restructured into reusable partials (\_fields, \_form, \_reference\_fields, \_hoc\_reference\_fields) to improve maintainability. A key behavioral change is the addition of a read-only mode for attachment forms, which disables the input fields and hides the Save/Cancel buttons when the read\_only flag is set. The form now explicitly supports setting the locale on HTML attachments for non-English consultations and CfE responses. Additionally, new fields have been added to capture House of Commons paper numbers and Parliamentary sessions, alongside existing Command paper and ISBN fields, allowing users to correctly reference official documents.

app/views/admin/shared/attachments · high confidence

Refactored edition filtering and search scopes into modular concerns

The edition filtering and search capabilities have been reorganized into distinct, modular concerns (e.g., \FilterableByAuthor\, \FilterableByBrokenLinks\, \SearchableByTitle\). This change introduces specific filtering options, such as identifying editions with broken or 'danger' links, excluding featured editions from specific lists, and searching by title or slug. It also adds scopes for filtering by author, date, organization, topical event, and document type, providing a more structured and granular way to query and manage editions in the admin interface.

app/models/concerns/edition/scopes · high confidence

Refactored file attachment editing interface

The file attachment editing workflow has been restructured to support read-only modes and modularized view components. A new \\_fields.html.erb\ partial now handles the core attachment data inputs, including file upload logic, accessibility toggles, and hidden field management for file caching and replacement. The \edit.html.erb\ view has been updated to render this shared form partial and conditionally display a back link when the attachment is in a read-only state, allowing administrators to view attachment details without the ability to modify them.

_app/views/admin/file\attachments · high confidence

Refactored publishing API presenters into modular helpers

The code in app/helpers/presenters has been reorganized into specific helper modules to improve maintainability and separation of concerns. New modules include DefaultNewsImageHelper for handling news image URLs, FeaturedDocumentsHelper for constructing featured document payloads (supporting editioned, topical event, and offsite link types), PayloadHeadingsHelper for extracting structured headings from Govspeak, and UpdateTypeHelper for determining minor or major update types. This refactoring extracts reusable logic previously embedded in larger presenter classes, ensuring that the publishing API payload generation is more modular and easier to test.

app/helpers/presenters · high confidence

Refactored service listeners for publishing, asset management, and dependency handling

The service listeners in app/services/service\_listeners have been restructured to improve reliability and consistency in content publishing workflows. The PublishingApiPusher now handles associated documents and translation removals synchronously for unpublishing and withdrawal events, ensuring immediate state updates. New listeners manage asset lifecycle: AttachmentAssetPublisher and DraftAttachmentAssetDiscarder now explicitly handle response form data for Consultations and Calls for Evidence, preventing orphaned assets. AttachmentUpdater and AttachmentRedirectUrlUpdater have been consolidated to ensure asset metadata and redirect URLs stay in sync with edition changes. Additionally, EditionDependenciesPopulator and AttachmentDependencyPopulator now reliably extract and persist contact and edition dependencies from Govspeak content, while EditorialRemaker and FeaturableOrganisationRepublisher provide dedicated handling for editorial remarks and feature-based republishing.

_app/services/service\listeners · high confidence

Refactored taxonomy data access with Redis caching and separated world/topic taxonomies

The taxonomy library has been restructured to improve performance and clarity. Data retrieval now uses a new Redis-based cache (RedisCacheAdapter) with a 60-second generation timeout and reconnection strategy, replacing previous in-memory or direct API calls. The monolithic taxonomy logic has been split into distinct TopicTaxonomy and WorldTaxonomy classes, each using a dedicated PublishingApiAdapter to fetch data from the Publishing API. A new Taxon model encapsulates taxon properties (including phase and visibility flags) and tree navigation methods (ancestors, descendants, breadcrumbs), while the Tree class handles recursive parsing of the API response into this object structure. This separation ensures world taxons are processed independently from topic taxons, and visibility filtering is applied consistently.

lib/taxonomy · high confidence

Refined authorization rules for Fatality Notices and Standard Editions

The system now enforces stricter access controls for specific content types. Fatality Notices are restricted to GDS editors and users from organizations that explicitly handle fatalities. Standard Editions are now limited to GDS admins and can be further scoped to specific organizations via settings, ensuring that only permitted entities can interact with these editions.

lib/whitehall/authority/rules · high confidence

Rename Document model to Edition

The core content model previously named Document has been renamed to Edition throughout the application. This change updates the model class, associated database table references, and internal method names (such as Document\#author becoming Edition\#creator) to better reflect that the system manages versions of content rather than static documents. Users will see this reflected in the admin interface and backend logic where 'Edition' is now the standard term for a piece of content being managed.

ruby · high confidence

Replace default Rails static pages with custom error pages and schema

The default Rails static pages (404, 422, 500, and the welcome index) have been removed from the public directory. They are replaced by a new custom 406 Unsupported Browser page and a JSON schema for configurable document types. Additionally, the default Rails icon has been replaced with a custom SVG icon, and the robots.txt file has been updated to remove the default comment block.

public · high confidence

Reslugs content for the monarch change and department rebrand

Data migrations update URLs to reflect the transition from Her Majesty to His Majesty, replacing terms like 'Queens Bench' and 'Her Majestys' with 'Kings Bench' and 'His Majestys' across publications, statistics, organisations, and ministerial roles. Additionally, URLs for the Department for International Trade are reslugged to Department for Business and Trade across all worldwide organisation pages and locales.

_db/data\migration · high confidence

Restructured JavaScript bundling and upgraded to GOV.UK Frontend v5 components

The application's JavaScript build has been reorganized to explicitly require individual components from \govuk\_publishing\_components\ rather than using a catch-all \require\_tree\, improving maintainability and load efficiency. A new \es6-components.js\ file has been introduced to handle ES6-dependent components (such as buttons, checkboxes, and tabs) via a \type="module"\ script tag, ensuring graceful degradation for older browsers that do not support ES6. Additionally, the \application.js\ manifest now explicitly includes specific admin modules (like the document history paginator and locale switcher) and GA4 analytics trackers, replacing the previous broad inclusion strategy with a more granular and controlled asset pipeline.

app/assets/javascripts · high confidence

Schema-driven validation and attribute handling for configurable content blocks

Standard edition content blocks now derive their attributes and validation rules from a JSON schema rather than hardcoded values. This change introduces dynamic attribute casting (including support for date and array types) and enforces a suite of validators defined in the schema, such as checks for safe HTML, valid internal paths, embedded contacts, social media links, and length limits. Users will experience stricter data integrity checks when editing or publishing content, with errors mapped to specific fields via dotted attribute names.

_app/models/standard\edition · high confidence

Standard editions now support configurable taxons, child document relationships, and tab-scoped validation

Standard editions now allow taxons to be enabled or required per document type via settings, rather than being universally mandatory. The system enforces parent-child document relationships, ensuring that a child document's type is permitted by its parent's configuration and that the parent edition exists. Block content validation is now scoped to individual tabs, preventing duplicate errors and allowing field-specific validation rules. Additionally, lead image handling has been updated to support multiple image sources and usage types, with fallbacks to default or placeholder images.

_app/models/concerns/standard\edition · high confidence

Support for adding Welsh-language mainstream URLs to document collections

Users can now add mainstream GOV.UK URLs, including Welsh-language pages, to document collection groups. This change introduces a new validation and persistence layer (\DocumentCollectionNonWhitehallLink::GovukUrl\) that resolves content items by base path, supporting both English and Welsh locales, and ensures that guide sub-pages are correctly handled as valid links within collections.

_app/models/document\_collection\_non\_whitehall\link · high confidence

Updated shared UI components and added Asset Manager session handling

The shared view templates have been updated to use the GOV.UK Design System, including a new header with GA4 navigation tracking, phase banners for 'What's new', feedback, and maintenance notices, and a republishing form with submission prevention. Additionally, a new partial ensures the Asset Manager session cookie is initialized before loading images to prevent session invalidation.

app/views/shared · high confidence

Upgrade to Rails 8 and modernize environment configurations

The application has been upgraded to Rails 8, requiring a comprehensive update to the development, test, and production environment configurations. Key changes include replacing the deprecated \config.cache\_classes\ with \config.enable\_reloading\ and \config.eager\_load\, and updating static asset serving to use \config.public\_file\_server\ instead of \config.serve\_static\_assets\. The configuration now enforces stricter security and development practices, such as raising errors on unpermitted parameters in development and test modes, enabling server timing, and configuring specific asset compression (using Terser in production). Additionally, production logging has been standardized to use STDOUT when \RAILS\_LOG\_TO\_STDOUT\ is set, and host authorization is explicitly configured to protect against DNS rebinding attacks.

config/environments · high confidence

World location news admin pages migrated to GOV.UK Design System

The admin interface for managing world location news has been redesigned using the GOV.UK Design System components. The index page now uses tabs to separate active and inactive locations, displaying details in a structured table. The show page presents location information via a summary list, while the edit page utilizes standard form components for updating titles, mission statements, and featured links. The features page has been restructured into tabs for currently featured content, GOV.UK content, topical events, and external websites, improving the organization and consistency of the administrative workflow.

_app/views/admin/world\_location\news · high confidence

Test coverage

15 commits adding/updating tests in test/functional; 18 commits adding/updating tests in test/unit/app/models/concerns/standard\_edition; Add acceptance tests for broken link reporting and admin dashboard; Add functional tests for the Generic Editions Controller; Added Jasmine test helpers for form input generation; Added JavaScript test coverage for admin modules; Added JavaScript tests for Govspeak Editor and Image Cropper components; Added component tests for Child Of Banner, Datetime Fields, Govspeak Editor, Image Cropper, and Inset Prompt; Added functional test coverage for admin controllers; Added integration test for link checker API webhook signature validation; Added integration tests for attachment lifecycle and access control in Asset Manager; Added test coverage for GA4 analytics modules; Added test coverage for national applicability in publications; Added test fixtures for StandardEditionMigrator; Added test fixtures for data migration validation; Added test fixtures for importers and validation scenarios; Added tests for NationApplicabilityHelper; Added tests for StandardEdition::HygieneEnforcer; Added tests for WithNestedAttributeErrors support module; Added tests for admin ViewComponents; Added tests for admin edition view components; Added tests for configurable document schema validation; Added tests for edition show page preview, sidebar, and translation components; Added tests for national applicability in Detailed Guides; Added tests for the Featured Documents Table component; Added tests for the Organisation show summary list component; Added tests for the admin social media accounts summary card component; Added tests for the worldwide office summary card component; Added tests for the worldwide organisation page summary card component; Added unit tests for Asset Manager services; Added unit tests for AssetData, ImageKind, and Replaceable concerns; Added unit tests for Document::PaginatedTimeline; Added unit tests for DocumentTypesConcern; Added unit tests for Edition model concerns; Added unit tests for FindAndReplaceEmbedCodesService; Added unit tests for GOV.UK URL validation in document collections; Added unit tests for Govspeak extractors; Added unit tests for LinkCheckerApiReport::Link; Added unit tests for Organisation model type concerns and scopes; Added unit tests for Publishing API payload builders; Added unit tests for Sidekiq asset and publishing jobs; Added unit tests for StandardEdition::BlockContent validation rules; Added unit tests for StandardEditionMigrator recipes; Added unit tests for String\#articleize and TranslationsForAssociations; Added unit tests for Whitehall authority and access control rules; Added unit tests for Whitehall core libraries; Added unit tests for address formatting and publishing API redirects; Added unit tests for admin edition and statistics announcement filters; Added unit tests for admin helper methods; Added unit tests for application validators; Added unit tests for application, attachment, and organisation helpers; Added unit tests for attachment and default storage classes; Added unit tests for attachment republishing rake tasks; Added unit tests for configurable content block rendering; Added unit tests for core library components; Added unit tests for data hygiene rake tasks; Added unit tests for data hygiene utilities; Added unit tests for document export, social media index, publishing API, and role type presenters; Added unit tests for edition lifecycle and bulk republishing services; Added unit tests for election, publishing, and reporting rake tasks; Added unit tests for inflections, MySQL safety, WIP features, and translations; Added unit tests for model and decorator logic; Added unit tests for service listeners in the publishing workflow; Added unit tests for taxonomy library components; Added unit tests for the PaginatedTimelineQuery class; Added unit tests for uploader storage and validation logic; Added unit tests for view components; Added view component tests for edition image management; Comprehensive test factory suite for edition types and assets; Cucumber feature test suite restructured with Playwright driver and new support helpers; Expanded unit tests for Publishing API presenters; Extracted national applicability tests into a dedicated file; New admin feature tests for broken link reporting, dashboard, editorial remarks, and document filtering; New test support helpers for admin controller workflows; Removed obsolete browsing performance test; Test infrastructure modernization and parallelization support.

Dependencies

Routine dependency updates across the application

This release updates a wide range of Ruby and JavaScript dependencies, including major version bumps for Rails (up to 8.1.2), govuk\_publishing\_components, gds-api-adapters, govspeak, and view\_component, alongside numerous patch and minor updates for gems such as nokogiri, slimmer, and gds-sso. These changes ensure the application uses the latest stable versions of its core libraries, incorporating upstream bug fixes, security patches, and compatibility improvements for the current Ruby and Rails environments.

(dependencies) · high confidence

Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

How this codebase got here

This is the PUBLIC form of this artifact. Findings are listed in full, but the details of SECURITY findings — which rule fired, in which file, on which line, and how to fix it — are deliberately withheld, and any secret-scanner results are excluded entirely. Where detail is absent here it was REMOVED FOR PUBLICATION; it is not missing from the analysis. The complete artifact is available from the repository owner.

Score

  • CAI 49 → 49 (+0.4)
  • Rubric changed (rubric-2026.10.5 → rubric-2026.11.2) — scores are not directly comparable.

Lenses

  • Code Health 51 → 51 (-0.0)
  • Architecture 89 → 87 (-2.4)
  • Maturity 56 → 87 (+31.4)
  • Readiness 71 → 71 (+0.0)
  • Security 41 → 40 (-1.8)
  • Domain Modelling 63 → 63 (-0.1)
  • Accessibility 53 → 53 (-0.1)

Resolved (26)

  • Documentation: no project overview (docs/tips_for_local_development.md)
  • High CVE: [GHSA redacted] (yarn.lock)
  • High CVE: [GHSA redacted] (yarn.lock)
  • High CVE: [GHSA redacted] (yarn.lock)
  • High CVE: [GHSA redacted] (yarn.lock)
  • High CVE: [GHSA redacted] (yarn.lock)
  • High: security finding (details withheld)
  • High: security finding (details withheld)
  • High: security finding (details withheld)
  • High: security finding (details withheld)
  • High: security finding (details withheld)
  • Medium CVE: [GHSA redacted] (yarn.lock)
  • Medium CVE: [GHSA redacted] (yarn.lock)
  • Off-boarding risk: anonymized user #1
  • Off-boarding risk: anonymized user #2
  • Orphaned file (app/controllers/admin/contacts_controller.rb)
  • Orphaned file (app/controllers/admin/fact_check_requests_controller.rb)
  • Orphaned file (app/controllers/admin/promotional_feature_items_controller.rb)
  • Orphaned file (app/helpers/admin/organisation_helper.rb)
  • Orphaned file (app/mailers/mail_notifications.rb)
  • …and 6 more

New (26)

  • ADR Consequences section is empty (docs/adr/0006-config-driven-content-types.md)
  • ADR Context section is empty (docs/adr/0006-config-driven-content-types.md)
  • ADR declares no status (docs/adr/0003-worldwide-organisation-multi-part-content.md)
  • ADR has no Consequences section (docs/adr/0003-worldwide-organisation-multi-part-content.md)
  • ADR has no Consequences section (docs/adr/0004-content-object-store-added-with-a-rails-engine.md)
  • Classify ADR enforcement: 1. Add View Components (docs/adr/0001-add-view-components.md)
  • Classify ADR enforcement: 2. New Asset Model (docs/adr/0002-new-asset-model.md)
  • Classify ADR enforcement: 3. Using multi-part content for Worldwide Organisations (docs/adr/0003-worldwide-organisation-multi-part-content.md)
  • Classify ADR enforcement: 4. content-object-store-added-with-a-rails-engine (docs/adr/0004-content-object-store-added-with-a-rails-engine.md)
  • Classify ADR enforcement: 5. Use JSON Schema for configurable document schemas (docs/adr/0005-use-json-schema-for-flexible-page-schemas.md)
  • Classify ADR enforcement: 6. Config driven content types (docs/adr/0006-config-driven-content-types.md)
  • Classify ADR enforcement: 7. Use Rails validation for configurable documents (docs/adr/0007-use-rails-validation-for-configurable-documents.md)
  • Classify ADR enforcement: 8. Drop JSON schema for specifying document properties in favour of our own custom schema definition (docs/adr/0008-drop-json-schema-for-document-configuration.md)
  • Classify ADR enforcement: 9. Separate configurable document forms and presenters from attribute schema (docs/adr/0009-configurable-document-forms-and-presenters.md)
  • High: security finding (details withheld)
  • Medium CVE: [GHSA redacted] (yarn.lock)
  • Medium CVE: [GHSA redacted] (yarn.lock)
  • Off-boarding risk: anonymized user #1
  • Off-boarding risk: anonymized user #2
  • Orphaned file (app/controllers/admin/people_controller.rb)
  • …and 6 more

Changes since last survey

  • 146 commits — 140 feature/other, 6 fixes

By area

  • (repo) — 61 commits
  • (root) — 31 commits
  • app/views — 13 commits
  • app/controllers — 9 commits
  • app/models — 6 commits
  • test/unit — 5 commits
  • app/helpers — 2 commits
  • db/data_migration — 2 commits
  • docs/roles_and_permissions.md — 2 commits
  • features/support — 2 commits
  • lib/whitehall.rb — 2 commits
  • app/assets — 1 commit
  • app/components — 1 commit
  • app/presenters — 1 commit
  • app/services — 1 commit
  • config/locales — 1 commit
  • docs/access_limiting.md — 1 commit
  • features/step_definitions — 1 commit
  • lib/services.rb — 1 commit
  • lib/whitehall — 1 commit

Notable commits

  • fix: Fix cucumber require order so Sidekiq inline mode actually takes effect
  • fix: Fix file naming from .erb to .html.erb
  • fix: Merge pull request #11911 from alphagov/fix-tab-hover-colour
  • fix: Merge pull request #11912 from alphagov/fix-rejected-submitted-editions-with-unpublishings
  • fix: Merge pull request #11950 from alphagov/nation-applicability-error-summary-fix
  • fix: Reinstate minitest-mock and fix failing test
  • change: Add 'Topical Event About Page' child content type of Topical Events
  • change: Add 'parent' link
  • change: Add edition_type to ChildOfBanner component
  • change: Add a data migration to migrate submitted/rejected editions that have an unpublishing record but with stale status
  • change: Add ordering to child pages table
  • change: Add radio button options to the force publish page
  • change: Add validation for parent edition state
  • change: Assign a predictable ID to default checkboxes component's first item It was difficult to target the first element of the checkboxes field due to the ID being autogenerated by the publishing comoponent gem. Moreso, our error summary component needs to be able to dynamically link to the first element whenever there's a validation error per the design system guidance.
  • change: Authorise PromotionalFeatureItems actions
  • change: Block unpublishing a parent with visible or scheduled children
  • change: Block withdrawing a parent with published or scheduled children
  • change: Bump bootsnap from 1.26.0 to 1.26.1
  • change: Bump brace-expansion from 1.1.11 to 1.1.21
  • change: Bump capybara-playwright-driver from 0.5.13 to 0.5.14
  • …and 126 more

Architecture

  • Unchanged — 0 containers · 1 contexts · 0 edges

Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

Survey your own repository

alphagov/whitehall was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.

About this page

  • The score is its most recent published measurement, taken on 6 November 2026 at a pinned commit. It is not a live figure and does not change until the project is measured again.
  • Measured at commit 462bebdf1e83a66f1ddf70e24c7729331f938451 — the exact code this score is about.
  • Scored under rubric-2026.11.2 — the same rubric and the same method as every other entry in this index.
  • Measured by Canine Code Analyzer (cca.canine.dev) using cca measure-2026.11.3+preprod-60d1b390edf0.