Files
werkator/docs/prs/2026-10-18-PR#165-generated-sections.md
claude-code 512150c6ac
werkator build succeeded after 02:46
werkator/deploy build succeeded after 00:10
werkator/mutation build succeeded after 29:53
werkator 1.43.5: the AI review reports nothing about generated sections (#165)
Co-authored-by: claude-code <claude-code@javagil.de>
2026-10-19 06:30:28 +02:00

1.2 KiB

PR#165: The AI review reports nothing about generated sections of the docs

WARNING: This document describes only the change applied in this PR. It may already be outdated once the next PR is merged. Historic PR-documentation is not maintained along with new PRs — treat it as a snapshot, not as current documentation.

Problem

A tool can write a section of a doc, from a comment <!-- generated by … --> up to the next heading, e.g. tools/generate-verified-by of hsadmin-ng. Such a section holds long links, and nobody can change it by hand. Since werkrevisor 0.49.1 its writing rules skip such a section, and its own config tells the model and Codex to do the same. The review instructions of werkator come from its .werkrevisor.toml, which lacks this hint.

Non-Goals

  • No generated section in werkator itself; the hint keeps the instructions the same in all werk repositories.

Solution

  • .werkrevisor.toml: the review instructions tell the model to report nothing about a generated section.
  • Version 1.43.5 with an internal release-notes entry.

Additional Changes

None.