[Daniel Kirkland (d-kirkland)]

Summary

• The page imports RobotsDirective, RobotsDirectiveType, and RobotsUserAgentBlock from ValueObject; their source declares the Struct namespace. The edit updates both examples’ imports.
• The page calls $event->getParsedRobots(); the event exposes ParsedRobots $parsedResult, and the parser returns that property. The edit reads $event->parsedResult in both examples.
• The page passes userAgents: $aiCrawlers to RobotsUserAgentBlock; its constructor accepts one string $userAgent and an array of directives. The edit creates one block per crawler.
• The page calls $parsedRobots->addUserAgentBlock($aiBlock); ParsedRobots exposes readonly constructor properties, and the parser returns the event’s parsedResult. The edit assigns a new ParsedRobots with the original properties and added blocks.

Related links

• Docs: extend-robots-txt.md L56-L58
• Docs: extend-robots-txt.md L187
• Docs: extend-robots-txt.md L70
• Docs: extend-robots-txt.md L76
• Docs: extend-robots-txt.md L85
• Docs: extend-robots-txt.md L194
• Platform source (tag v6.7.15.1):
  • RobotsDirective.php L1-L3: RobotsDirective uses the Struct namespace.
  • RobotsDirectiveType.php L1-L3: RobotsDirectiveType uses the Struct namespace.
  • RobotsUserAgentBlock.php L14-L17: The constructor accepts a string $userAgent and an array of $directives.
  • RobotsDirectiveParsingEvent.php L19-L23: The event exposes parsedResult as a writable ParsedRobots property.
  • ParsedRobots.php L17-L21: ParsedRobots receives its blocks, orphaned directives, and issues as readonly properties.
  • RobotsDirectiveParser.php L141-L145: The parser dispatches the event and returns its parsedResult.

Checklist

• I reviewed affected links, code samples, and cross-references, including PageRef references where relevant. (Names and values were checked against the source at the tag linked above.)
• I added or updated redirects in .gitbook.yaml if pages were moved, renamed, or deleted. (N/A, no page moved.)
• I updated .wordlist.txt (and sorted it) if spellcheck flags new legitimate terms. (No new prose words.)
• Any required dependent changes in downstream modules have already been merged and published. (N/A)
• This pull request is ready for review.

Notes

• This PR was fully AI generated and requires human review. The text was drafted by an OpenAI model (gpt-6-luna) and checked by a second OpenAI model (gpt-6.1-sol), run from a Claude Code session. It has not been merged, approved or reviewed by a person. Please verify the claims and the changed text against the source before merging.
• Defect type: Breaks (4 of 4 changes). A reader who follows the page as written ends up with code, markup or a command that fails or does not do what the page says.
• Codebase files this change was checked against (tag v6.7.15.1): src/Storefront/Page/Robots/Event/RobotsDirectiveParsingEvent.php L19-L23; src/Storefront/Page/Robots/Parser/ParsedRobots.php L17-L21; src/Storefront/Page/Robots/Parser/RobotsDirectiveParser.php L141-L145; src/Storefront/Page/Robots/Struct/RobotsDirective.php L1-L3; src/Storefront/Page/Robots/Struct/RobotsDirectiveType.php L1-L3; src/Storefront/Page/Robots/Struct/RobotsUserAgentBlock.php L14-L17.
• How it was found: a read-through of this page against shopware/shopware at tag v6.7.15.1, then an independent re-check by a second AI model that re-read the page and the cited source files. Please check the cited lines yourself before merging.
• Scope: main (Shopware 6.7) only. Older docs branches are not touched.

🤖 Generated with Claude Code

[shopware-dev-docs-connector]

Developer Docs healthcheck

Status: Completed with success.
Repository: shopware/docs
Commit: 74b4626
Preview: https://developer-documentation-3z5b5e2yj-shopware-frontends.vercel.app
Workflow run: #5830

[github-actions]

📢 Developer Announcement Recommendation

Recommendation: ❌ No Announcement Recommended

No developer announcement signals were detected.

This PR does not appear to introduce developer-facing changes that require a community announcement.

[Daniel Kirkland (d-kirkland)]

Agent 00-Docs (an AI agent, posting from the PR author's account). Thanks for catching this: you were right, the page still used methods that do not exist.

I pushed follow-up commits to this branch (no force-push):

• getUserAgentBlocks(), getDirectives(), getType(), getValue() and addIssue() are gone from the page. The validation example now reads the public properties (userAgentBlocks, directives, type, value), builds ParseIssue with its real fields (lineNumber, lineContent, reason, severity), and assigns a rebuilt ParsedRobots to $event->parsedResult.
• The custom directive example now uses $event->directiveType and $event->handled instead of getDirectiveName() and setHandled().
• One commit (f036caa) added a line-number reconstruction that made the example too complex. The next commit (1a5560b) replaces it with the simple version, so ignore the first one.

I checked the new code against ParsedRobots, ParseIssue and RobotsDirectiveParsingEvent at v6.7.15.1, and a second AI model re-checked it. A person still needs to confirm it, and I have not tested the examples by running them. The (int) cast in the crawl-delay check is unchanged from the original page.