Link W3C Alt Decision Tree URL in alt-text system instruction#462
Link W3C Alt Decision Tree URL in alt-text system instruction#462adamsilverstein wants to merge 1 commit intoWordPress:developfrom
Conversation
Add the canonical guide URL (https://www.w3.org/WAI/tutorials/images/decision-tree/) inline with the named reference so the model has a concrete anchor for the decision framework, and future readers can find the authoritative source. Refs WordPress#461
|
The following accounts have interacted with this PR and/or linked issues. I will continue to update these lists as activity occurs. You can also manually ask me to refresh this list by adding the If you're merging code through a pull request on GitHub, copy and paste the following into the bottom of the merge commit message. To understand the WordPress project's expectations around crediting contributors, please review the Contributor Attribution page in the Core Handbook. |
Codecov Report✅ All modified and coverable lines are covered by tests. Additional details and impacted files@@ Coverage Diff @@
## develop #462 +/- ##
==========================================
Coverage 67.72% 67.72%
Complexity 959 959
==========================================
Files 60 60
Lines 4836 4836
==========================================
Hits 3275 3275
Misses 1561 1561
Flags with carried forward coverage won't be shown. Click here to find out more. ☔ View full report in Codecov by Sentry. 🚀 New features to boost your workflow:
|
|
Closing — the inline decision tree in the system instruction already specifies the decorative/functional/informative/complex rules explicitly, so adding the URL is unlikely to change model output. Not worth the churn for documentation-only value. Closing alongside #461. |
Summary
includes/Abilities/Image/alt-text-system-instruction.php.ai/alt-text-generationability.Why
Models trained on web content often have strong priors anchored to well-known URLs. Linking the canonical guide gives the model a concrete reference point for the decision framework the instruction explicitly names (decorative / functional / informative / complex). It also documents the authoritative source for anyone reading the prompt later.
What's not in this PR
Alt_Text_Generation.phpor the guidelines injection system — the URL belongs in the instruction itself, not a guideline CPT entry.Closes #461
Test plan
php -l includes/Abilities/Image/alt-text-system-instruction.phppassestests/e2e/specs/experiments/alt-text-generation.spec.jstests/e2e/specs/experiments/alt-text-generation-bulk.spec.js