Skip to content

changelog: validate rst entry line lengths - #4834

Open
dio wants to merge 2 commits into
envoyproxy:mainfrom
dio:changelog-rst-line-length
Open

changelog: validate rst entry line lengths#4834
dio wants to merge 2 commits into
envoyproxy:mainfrom
dio:changelog-rst-line-length

Conversation

@dio

@dio dio commented Aug 2, 2026

Copy link
Copy Markdown
Member

Summary

  • finish the per-entry changelog cleanup by resolving current entries from current_dir_path and removing the obsolete entries_layout check
  • reject breakable lines longer than 136 characters in current RST changelog entries
  • report every violation with its file, line number, actual length, and maximum length
  • allow a single unbreakable token, matching Envoy yamllint behavior

Rationale

Envoy limits YAML lines to 140 characters. Changelog entries are emitted as YAML block scalars with four spaces of indentation, so source RST lines must be at most 136 characters. This is validation-only: automatically wrapping RST roles, links, lists, or literal blocks could change their meaning.

Testing

  • pants fmt py/envoy.code.check::
  • pants lint py/envoy.code.check::
  • pants check py/envoy.code.check::
  • pants test py/envoy.code.check::
  • built the local package and ran envoy.code.check --check changelog against an Envoy checkout, confirming overlong entries fail and wrapped entries pass

Follow-up

After this change is released, an Envoy follow-up will update the envoy-code-check dependency, wrap the existing overlong RST entries, and run bazel test //tools/code:check_test. That follow-up will complete envoyproxy/envoy#46148.

Part of envoyproxy/envoy#46148.

AI assistance was used to analyze the code, implement the change, and prepare tests. The submitter reviewed and verified the resulting changes.

dio added 2 commits August 2, 2026 07:46
Signed-off-by: Dhi Aurrahman <dio@rockybars.com>
Signed-off-by: Dhi Aurrahman <dio@rockybars.com>
@netlify

netlify Bot commented Aug 2, 2026

Copy link
Copy Markdown

Deploy Preview for nifty-bassi-e26446 ready!

Name Link
🔨 Latest commit 93bde6d
🔍 Latest deploy log https://app.netlify.com/projects/nifty-bassi-e26446/deploys/6a6e9679d569250008c479e3
😎 Deploy Preview https://deploy-preview-4834--nifty-bassi-e26446.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@phlax

phlax commented Aug 3, 2026

Copy link
Copy Markdown
Member

@dio thanks for this, will look shortly - other pipelines are taking longer to resolve than i hoped, and i have some python stuff that needs testing already so will look at this when i get to py stuff

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.

2 participants