docs(zsh-lint): sync generated reference

[z-shell-wiki-docs-sync]

Automated reference sync from z-shell/zsh-lint.
Generated from published rule documentation. Do not hand-edit the marked region.
Published source: v1.6.0
Source commit: f6341241c398fd2a784452e75895dafb06186bbc
Refs z-shell/zsh-lint#743

[cloudflare-workers-and-pages]

Deploying zsh with    Cloudflare Pages

Latest commit:	41ff136
Status:	✅  Deploy successful!
Preview URL:	https://efb042a5.zsh.pages.dev
Branch Preview URL:	https://docs-zsh-lint-reference.zsh.pages.dev

View logs

[ss-o]

Fallback review under ADR-0026: Copilot request not registered on 41ff136

Sole-maintainer exception

The maintainer elected the ADR-0035 sole-maintainer exception for this pull request at head 41ff136. No second human reviewer is available, and the configured Copilot request on this head did not register (requested 2026-10-19T17:51:21Z, no review_requested event for Copilot; cause unconfirmed). A new head voids this election and this review.

Findings

No actionable findings.

Scope: the complete diff from main at aa3e736 to 41ff136: one generated file, community/04_zsh_lint/08_rule_reference.mdx, produced by the zsh-lint reference sync from the published v1.6.0 release (z-shell/zsh-lint commit f634124).

Note

This fallback review and the exact-head review below are not a human review or an approval to merge.

Exact-head read-only review

A read-only exact-head review of this commit, in its own reviewing session using the organization code-review checklist, reported no actionable findings. Its evidence:

• Every hunk lies inside the zsh-lint:generated markers (lines 21 and 523). Frontmatter and hand-written text are byte-identical to main.
• The provenance notice names v1.6.0, commit f634124, and go install ...@v1.6.0.
• All 16 rules with an ID in internal/rules at the tag appear once in the list and once as a heading, and the anchors resolve. The one addition is plugin/project-unload-lifecycle; every rule on main keeps its ID.
• Six rule bodies match their Go doc comments word for word: plugin/project-unload-lifecycle, plugin/unload-function, quoting/unquoted-var, compat/special-param-shadow, security/eval and plugin/zero-handling.
• There is no unescaped <, >, { or } outside code. \*\_functions, \*.plugin.zsh and zle-\* are escaped literals, and every fence declares zsh. scripts/validate-frontmatter.mjs and scripts/validate-code-fences.mjs pass.
• Unavailable there: a full Docusaurus build, because that read-only session had no installed dependencies.

Validation

• Passed on the head: every pull-request check, including Branch Name, Issue Link, PR Title, Commits, Trunk Code Quality, CodeQL, Org Routing, Validate Corpus and the Cloudflare Pages preview build, which compiles the MDX.
• Reproduced for this review: the hunk list stays between lines 24 and 415 of the generated region, the 16 rule headings equal the 16 ID: lines in the v1.6.0 sources, and no heading on main is missing from the head.

Checklist verdicts and supporting evidence

• Scope and ownership: pass. Only the generated region changed, and the zsh-lint sync workflow owns it. Hand-edits there would be overwritten by the next sync.
• Correctness: pass. The reference matches the published v1.6.0 sources rule for rule. It replaces the v1.3.0 reference that main still showed.
• Rendering: pass. The preview build compiled the page, the MDX hazards are escaped, and the fences are labelled.
• Traceability: pass. The body references z-shell/zsh-lint#743, the pull request that produced the tag commit, and the provenance notice links the exact source commit.
• Supply chain and deployment: pass. The commit is a verified signed commit from the wiki sync app. The change is content only, with no dependency, workflow or configuration change.

Limits and recovery

• Unavailable: a full local Docusaurus build. The Cloudflare Pages preview build on this head is the build evidence.
• Recovery: if the deployed page renders incorrectly after merge, revert the squash commit on main. The previous v1.3.0 reference then returns until the sync's next run produces a corrected pull request.