Skip to content

refactor: rename headless-documents to hwp-documents - #829

Merged
josephfusco merged 2 commits into
mainfrom
chore/rename-hwp-documents
Oct 23, 2026
Merged

josephfusco merged 2 commits into
mainfrom
chore/rename-hwp-documents

Conversation

@josephfusco

Copy link
Copy Markdown
Member

Follow-up to #818. Renames the new plugin to match the repo's naming pattern, and moves it from changesets to release-please. It's still 0.0.0 and unreleased, so the rename breaks nothing.

Why

What changes

  • plugins/headless-documents → plugins/hwp-documents, and the main file → hwp-documents.php. Identifiers are renamed case by case to match hwp-previews:
    • namespace Headless\Documents → HWP\Documents
    • constants HEADLESS_DOCUMENTS_* → HWP_DOCUMENTS_*
    • hooks, options, capabilities, and the table headless_document(s)_* → hwp_document(s)_*
    • text domain and REST namespace headless-documents → hwp-documents
    • display name → "HWP Documents"
    • package names → @wpengine/hwp-documents-wordpress-plugin and wpengine/hwp-documents
  • The custom phpcs standard HeadlessStandard → HWPStandard, the same name hwp-previews uses. In the PrefixAllGlobals list, the bare headless prefix becomes hwp_document, so the singular hook names still pass.
  • Adds the plugin to release-please-config.json and the manifest at 0.0.0. The first feat: merge will propose 0.1.0, which matches the minor bump the deleted changeset asked for.
  • Deletes .changeset/headless-documents-initial.md, which also removes the .changeset/ folder.
  • Updates references in .github/dependabot.yaml, docs/index.md, llms.txt, and plugins/README.md.
  • Lockfiles: refreshed the composer.lock content-hash and the pnpm-lock.yaml path. No dependency versions changed.

Testing

  • composer validate, php -l on every file, phpcs, and phpstan pass. psalm ran without errors.
  • wpunit and e2e need the Docker environment and haven't run locally; CI covers them.
  • git grep finds no remaining headless-documents, headless_document, Headless\, or HeadlessStandard outside lockfiles.
Use of AI Tools

AI assistance: Yes
Tool(s): Claude Code
Model(s): Claude Opus 5.5
Used for: Assisting with the plugin rename, release-please registration, and running static checks.

@changeset-bot

changeset-bot Bot commented Oct 22, 2026 •

Copy link
Copy Markdown

⚠️ No Changeset found

Latest commit: a158557

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

@github-actions

Copy link
Copy Markdown
Contributor

📦 Plugin Artifacts Ready!

Download from GitHub Actions run

Available plugins:

  • ✅ hwp-documents.zip

See the "Artifacts" section at the bottom of the Actions run page

@github-actions

Copy link
Copy Markdown
Contributor

🔍 WordPress Plugin Check Report

❌ Status: Failed

📊 Report

🎯 Total Issues ❌ Errors ⚠️ Warnings
17 17 0

❌ Errors (17)

📁 .env.dist (2 errors)
📍 Line 🔖 Check 💬 Message
0 hidden_files Hidden files are not permitted.
0 application_detected Application files are not permitted.
📁 .docker/.env.ci (1 error)
📍 Line 🔖 Check 💬 Message
0 hidden_files Hidden files are not permitted.
📁 .editorconfig (1 error)
📍 Line 🔖 Check 💬 Message
0 hidden_files Hidden files are not permitted.
📁 .wp-env.json (1 error)
📍 Line 🔖 Check 💬 Message
0 hidden_files Hidden files are not permitted.
📁 phpstan.neon.dist (1 error)
📍 Line 🔖 Check 💬 Message
0 application_detected Application files are not permitted.
📁 bin/build-docker.sh (1 error)
📍 Line 🔖 Check 💬 Message
0 application_detected Application files are not permitted.
📁 bin/_lib.sh (1 error)
📍 Line 🔖 Check 💬 Message
0 application_detected Application files are not permitted.
📁 bin/sync-package-version.sh (1 error)
📍 Line 🔖 Check 💬 Message
0 application_detected Application files are not permitted.
📁 bin/run-codeception.sh (1 error)
📍 Line 🔖 Check 💬 Message
0 application_detected Application files are not permitted.
📁 bin/install-plugins.sh (1 error)
📍 Line 🔖 Check 💬 Message
0 application_detected Application files are not permitted.
📁 bin/install-test-env.sh (1 error)
📍 Line 🔖 Check 💬 Message
0 application_detected Application files are not permitted.
📁 bin/local/run-qa.sh (1 error)
📍 Line 🔖 Check 💬 Message
0 application_detected Application files are not permitted.
📁 bin/local/run-unit-tests.sh (1 error)
📍 Line 🔖 Check 💬 Message
0 application_detected Application files are not permitted.
📁 .docker/init-docker.sh (1 error)
📍 Line 🔖 Check 💬 Message
0 application_detected Application files are not permitted.
📁 hwp-documents.php (1 error)
📍 Line 🔖 Check 💬 Message
0 plugin_updater_detected Including An Update Checker / Changing Updates functionality. Plugin Updater detected. Use of the Update URI header is not allowed in plugins hosted on WordPress.org.
📁 readme.txt (1 error)
📍 Line 🔖 Check 💬 Message
0 outdated_tested_upto_header Tested up to: 7.0 < 7.1. The "Tested up to" value in your plugin is not set to the current version of WordPress. This means your plugin will not show up in searches, as we require plugins to be compatible and documented as tested up to the most recent version of WordPress.

🤖 Generated by WordPress Plugin Check Action • Learn more about Plugin Check

@josephfusco
josephfusco marked this pull request as ready for review October 23, 2026 15:00
@josephfusco
josephfusco merged commit 1dff632 into main Oct 23, 2026
@josephfusco
josephfusco deleted the chore/rename-hwp-documents branch October 23, 2026 15:00
@josephfusco josephfusco added [Type] Task Maintenance, upkeep, and other non-functional work [Area] Documents Issues for the headless documents plugin labels Oct 23, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

[Area] Documents Issues for the headless documents plugin [Type] Task Maintenance, upkeep, and other non-functional work

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant