From 3954e28cb30e7e4e7e348a803d3dec5523226ba9 Mon Sep 17 00:00:00 2001 From: Raghad Dahi Date: Tue, 31 Mar 2026 12:56:29 +0200 Subject: [PATCH] feat: add content freshness agent skill and 7.4 release notes --- prompts/content/en-latest/releases/7.4.md | 142 ++++++++++++++++++ .../maintenance/content-freshness/README.md | 17 +++ .../content-freshness/content-freshness.md | 37 +++++ 3 files changed, 196 insertions(+) create mode 100644 prompts/content/en-latest/releases/7.4.md create mode 100644 prompts/maintenance/content-freshness/README.md create mode 100644 prompts/maintenance/content-freshness/content-freshness.md diff --git a/prompts/content/en-latest/releases/7.4.md b/prompts/content/en-latest/releases/7.4.md new file mode 100644 index 00000000..7266da53 --- /dev/null +++ b/prompts/content/en-latest/releases/7.4.md @@ -0,0 +1,142 @@ +Wagtail 7.4 (LTS) release notes +Unreleased + +What’s new + +Upgrade considerations - changes affecting all projects + +Upgrade considerations - deprecation of old functionality + +Upgrade considerations - changes affecting Wagtail customizations + +Upgrade considerations - changes to undocumented internals + +Wagtail 7.4 is designated a Long Term Support (LTS) release. Long Term Support releases will continue to receive maintenance updates as necessary to address security and data-loss related issues, up until the next LTS release (typically a period of 12 months). + +What’s new +Autosave UX improvements +The autosave and concurrent editing notifications features have been improved based on user feedback. The improvements include: better handling of race conditions and network failures, refined messaging and alignment of indicator elements, as well as clearer display of idle users editing the same page. + +These improvements were developed by Sage Abdullah, with support from the Wagtail UI team. + +Deferred validation for StreamField blocks when saving drafts +StreamField blocks now support deferred validation of required fields when saving drafts of pages (or snippets using DraftStateMixin). Users can now add a StreamField block and save work-in-progress versions without filling in all fields of the block. Validation is applied as normal when the page or snippet is published, scheduled, or submitted to a workflow. + +The new behavior is enabled by default, but individual field blocks can opt out by setting the required_on_save option to True. All blocks now also have an is_deferred_validation attribute that can be used in custom validation logic to conditionally skip validation when saving drafts. For more details, refer to StreamField validation. + +This feature was developed by Sage Abdullah. + +Preview compatibility for cookie-based sessions +The preview feature has been improved to be more compatible with projects that use signed cookies as the sessions backend for Django. Previewing large pages in Wagtail no longer causes the session cookie to exceed the cookie size limit enforced by browsers. + +This feature was developed by Sage Abdullah. + +Other features +Add is_deferred_validation flag to support skipping custom validation when saving drafts (Daniel Kirkham) + +Update project template Dockerfile to build dependencies in a separate stage (Brylie Oxley, Akshat Gupta) + +Add include_root parameter to admin pages API endpoint (Divyansh Mishra) + +Add support for Flourish oEmbeds (Garrett Coakley) + +Add support for Heyzine oEmbeds (Baptiste Darthenay) + +Allow specifying creation_form_class on ChooserViewSet as a dotted path string (K Adithya) + +Add WAGTAILDOCS_MAX_UPLOAD_SIZE setting for specifying maximum document file size (Om Harsh) + +Optimize combining of querysets in site history report (Alex Bridge) + +Add more informative error for format-* operations on SVG images (Ankit Kumar) + +Bug fixes +Handle nested inline models when displaying object usage information (Sage Abdullah, Kacper Walęga, Tian Jie Wong) + +Avoid duplicate get_object() DB query in API detail view (Siddheshwar Kadam) + +Ensure ImageBlock alt text populates on choosing a new image after unchecking decorative state (Pratham Jaiswal) + +Set verbose_name_plural for Query model in search promotions app (Saptami) + +Truncate overly long task names in workflow admin view (Gaurav Takhi) + +Hide “Add child page” button when no child pages can be created as per max_count or max_count_per_parent (Lasse Schmieding) + +Use POST instead of DELETE in Cloudflare Frontend Cache Backend (Tom Usher) + +Handle null values for title, author name or provider name in OEmbed responses (Baptiste Darthenay) + +Preserve original data types from ChoiceBlock choices in block values (Devarshi Mani Tripathi) + +Documentation +Add documentation for the filter_spec parameter of ImageRenditionField (Soumya-codr) + +Add guide for testing document upload forms (Wenli Tsai, Bhavesh Sharma) + +Document the nested_default_fields attribute on API viewsets (Deepanshu Tevathiya) + +Replace http with https in example URLs (Kunal Gupta) + +Use pathlib.Path for settings in “Integrating into Django” documentation (Kunal Gupta) + +Clarify example of how to implement custom embed finders (Naman Sharma S) + +Add documentation for using the ReferenceIndex API (Saptami) + +Retitle documentation page for settings contrib module to “Settings models” (Karl Hobley) + +Fix typos and minor grammar issues (Kunal Gupta) + +Correct references to macOS and POSIX shell in tutorial (Ankit Kumar) + +Add PowerShell setup instructions to tutorial and correct method versus property terminology (Mustansir Dabhiya) + +Fix ordering of image rendition documentation (Seb Corbin) + +Remove references to now-addressed Django accessibility issues (Nirmal Kumar) + +Maintenance +Removed support for Django 4.2 + +Fix LocaleController test failures caused by differing timezone representations between Node versions (Saptami, Matt Westcott) + +Fix frontend coverage upload to Codecov (Sage Abdullah) + +Update semgrep to 1.150.0 (Pravin Kamble) + +Fix hash_filelike test case to account for line break differences on Windows (Mustansir Dabhiya) + +Fix temporary file handling in redirect import tests on Windows (Mustansir Dabhiya) + +Fix use of platform-specific date formatting in edit handler tests (Mustansir Dabhiya) + +Bump Node.js to 24 (active LTS), upgrade Jest and Storybook (Sage Abdullah) + +Use Docker Elasticsearch images for GitHub CI instead of unofficial actions (Matt Westcott) + +Make LocaleController tests robust against changes to timezone data in Node (Sage Abdullah) + +Fix PermissionError on document serve tests under Windows (Matt Westcott) + +Update JavaScript linting to ESLint 9, with updated linting rules and related fixes (Sage Abdullah) + +Replace Puppeteer with Playwright for integration tests (Sage Abdullah) + +Upgrade to latest Sass with changes for deprecated if syntax (Sage Abdullah) + +Add explicit timeout-minutes to GitHub Actions workflow jobs (Ashutosh) + +Upgrade Python tooling, testing, and docs dependencies (Sage Abdullah) + +Support skipping transaction unit tests with a tag (Sage Abdullah) + +Remove unreachable code in wagtail.py (Oluwagbeminiyi Agbedejobi) + +Upgrade considerations - changes affecting all projects +Upgrade considerations - deprecation of old functionality +Removed support for Django 4.2 +Django 4.2 is no longer supported as of this release; please upgrade to Django 5.2 or above before upgrading Wagtail. + +Upgrade considerations - changes affecting Wagtail customizations +Upgrade considerations - changes to undocumented internals diff --git a/prompts/maintenance/content-freshness/README.md b/prompts/maintenance/content-freshness/README.md new file mode 100644 index 00000000..f4b83cc8 --- /dev/null +++ b/prompts/maintenance/content-freshness/README.md @@ -0,0 +1,17 @@ +# Content Freshness Skill + +An AI-powered system for maintaining the [Wagtail User Guide](https://guide.wagtail.org) after each new release. + +## Overview +This skill identifies documentation pages and screenshots that have become outdated due to new Wagtail features. It uses an AI agent to perform a semantic comparison between new release notes and the existing guide content. + +## File Structure +- `content-freshness.md`: The "brain" of the skill. Contains the core logic, analysis filters, and output constraints for the AI Agent. + +## Workflow +To use this skill, provide the AI agent with the contents of `content-freshness.md` along with the specific **Release Notes** and **Guide Context** (`llms-full.txt`) for the version you are auditing. + +## Maintenance Rules +* **Do Not Edit Releases**: The AI is strictly instructed to never suggest changes to pages within the `/releases/` directory, as these are historical records. +* **Screenshot Priority**: Any change involving a UI update is automatically flagged as **HIGH** priority to ensure visuals remain accurate. +* **User-Facing Focus**: The analysis filters out developer-specific changes (APIs, CLI updates) to focus purely on the experience for Editors and Administrators. \ No newline at end of file diff --git a/prompts/maintenance/content-freshness/content-freshness.md b/prompts/maintenance/content-freshness/content-freshness.md new file mode 100644 index 00000000..be10315c --- /dev/null +++ b/prompts/maintenance/content-freshness/content-freshness.md @@ -0,0 +1,37 @@ +# Content Freshness Skill: AI Agent Instructions + +## Purpose +This skill identifies which Wagtail User Guide pages require updates to text or screenshots after a new release. It performs a **semantic comparison** between release notes and the guide's content to produce a maintenance checklist. + +## ⚠️ Critical Constraint +**DO NOT suggest changes to pages within the `/releases/` directory.** Release notes are historical records of a specific version and should not be modified. Focus exclusively on updating the "How-to," "Tutorials," and "Reference" sections of the guide. + +## Data Sources +- **Release Notes**: `prompts/content/en-latest/releases/new-in-wagtail-X.Y.md` +- **Guide Context**: `prompts/content/en-latest/llms-full.txt` + +## Instructions for the AI Agent + +### 1. Analysis Filter +Extract changes from the Release Notes that affect **Content Editors, Moderators, or Administrators**. +- **Include**: UI changes, new features, modified workflows, new settings. +- **Exclude**: Developer-only changes (APIs, CLI, dependencies) and existing Release Note pages. + +### 2. Semantic Matching & Prioritization +Compare features against `llms-full.txt`. Do not use generic keyword matching; map the *intent* of the feature to the relevant guide page. +- **HIGH**: UI has visually changed (Screenshots are definitely outdated). +- **MEDIUM**: A new feature/setting exists that the page doesn't mention yet. +- **LOW**: Minor tweaks or bug fixes with minimal visual impact. +- **NEW PAGE NEEDED**: Feature is entirely undocumented in the current guide. + +### 3. Required Output Format +Provide results EXACTLY in this format: + +[PRIORITY] Page Title +URL: https://guide.wagtail.org/en-latest/... +Reason: [Specific change from release notes] +Suggested Note: [Content for a VersionNoteBlock] +Screenshots: [Yes / No / Maybe] + +### 4. Summary +End with a tally of total pages to review, categorized by priority, and an estimated update time (assume 30m per LOW, 1h per MEDIUM, 2h per HIGH). \ No newline at end of file