Skip to content

docs: Add rule interface so we can publish docs on getrector.com#408

Merged
bbrala merged 6 commits into
mainfrom
fix/rule-documentation
Jul 9, 2026
Merged

docs: Add rule interface so we can publish docs on getrector.com#408
bbrala merged 6 commits into
mainfrom
fix/rule-documentation

Conversation

@bbrala

@bbrala bbrala commented Jul 9, 2026

Copy link
Copy Markdown
Collaborator

Description

To get rule docs on getrector.php we need to extend an interface. See rectorphp/rector#9778 (comment)

Drupal.org issue

Provide a link to the issue from https://www.drupal.org/project/rector/issues. If no issue exists, please create one and link to this PR.

bbrala added 5 commits July 9, 2026 09:35
PR #408 added the interface to rules extending base classes and a
subset of standalone rules, but 38 concrete rules extending
AbstractRector directly still lacked it. Rector's getrector.com docs
build the rule filter metadata from DocumentedRuleInterface, so these
rules would not be published. Adds the interface (all already define
getRuleDefinition()) so every rule is documented.
getrector.com's rule-docs build rejects code samples whose 'after'
(good code) is empty (Symplify AbstractCodeSample: "Good sample good
code cannot be empty"), so 11 code-removal rules were being skipped and
not shown on the site. Each now pairs the removed statement with an
adjacent statement the rule leaves untouched, so the diff renders the
removal and the after sample is non-empty. Reported by TomasVotruba.
@bbrala bbrala changed the title Fix rule interface so we can publish docs on getrector.com docs: Add rule interface so we can publish docs on getrector.com Jul 9, 2026
@bbrala bbrala merged commit 95343a4 into main Jul 9, 2026
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant