Skip to content

fix: correct release-note rendering (markdown list + dropped first char)#3476

Merged
tekton-robot merged 2 commits into
tektoncd:mainfrom
vdemeester:fix-release-notes-docs-list
Jul 1, 2026
Merged

fix: correct release-note rendering (markdown list + dropped first char)#3476
tekton-robot merged 2 commits into
tektoncd:mainfrom
vdemeester:fix-release-notes-docs-list

Conversation

@vdemeester

@vdemeester vdemeester commented Jun 30, 2026

Copy link
Copy Markdown
Member

Changes

Two fixes to the generated draft release notes (tekton/resources/release/base/github_release.yaml and github_release_oci.yaml):

1. Docs/Examples not rendered as a list

The Docs and Examples links were written as -[Docs @ ...] / -[Examples @ ...] (no space after the dash), so they were not valid markdown list items and rendered as a run-on line. Added the missing space (- [Docs @ ...]).

2. First character of every release-note description dropped

The release-note extraction used a fixed-width lookbehind:

grep -oPz '(?s)(?<=```release-note..)(.+?)(?=```)'

The trailing .. was intended to skip the line break after the fence assuming CRLF (\r\n). When the PR body uses LF line endings, .. matches the newline plus the first character of the note, so descriptions rendered as "rrors ..." instead of "Errors ...", "ump ..." instead of "Bump ...", etc.

Replaced the brittle regex with an awk extraction that captures the lines strictly between the ```release-note fences after normalising line endings, preserving the full description regardless of CRLF/LF.

Both observed in the tektoncd/pipeline v1.14.0 draft release notes.

/kind bug

Submitter Checklist

The generated draft release notes wrote the Docs and Examples links as
`-[Docs @ ...]` and `-[Examples @ ...]`, with no space after the dash.
Without the space these are not valid markdown list items and render as
a single run-on line. Add the missing space so they render as a list.
@tekton-robot tekton-robot added the size/XS Denotes a PR that changes 0-9 lines, ignoring generated files. label Jun 30, 2026
The release-note extraction used a fixed-width lookbehind:

    grep -oPz '(?s)(?<=```release-note..)(.+?)(?=```)'

The trailing `..` was intended to skip the line break after the
```release-note fence, assuming CRLF (\r\n). When the PR body uses LF
line endings the `..` matches the newline plus the first character of
the note, so descriptions rendered as "rrors ..." instead of
"Errors ...", "ump ..." instead of "Bump ...", etc.

Replace the brittle regex with an awk extraction that captures the
lines strictly between the ```release-note fences after normalising
line endings, so the full description is preserved regardless of CRLF
or LF.
@tekton-robot tekton-robot added size/S Denotes a PR that changes 10-29 lines, ignoring generated files. and removed size/XS Denotes a PR that changes 0-9 lines, ignoring generated files. labels Jun 30, 2026
@vdemeester vdemeester changed the title fix: render Docs/Examples as a markdown list in release notes fix: correct release-note rendering (markdown list + dropped first char) Jun 30, 2026
@tekton-robot

Copy link
Copy Markdown
Contributor

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: AlanGreene

The full list of commands accepted by this bot can be found here.

The pull request process is described here

Details Needs approval from an approver in each of these files:

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

@tekton-robot tekton-robot added the approved Indicates a PR has been approved by an approver from all required OWNERS files. label Jul 1, 2026
@anithapriyanatarajan

Copy link
Copy Markdown
Contributor

/lgtm

@tekton-robot tekton-robot added the lgtm Indicates that a PR is ready to be merged. label Jul 1, 2026
@tekton-robot tekton-robot merged commit e3cab8b into tektoncd:main Jul 1, 2026
9 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

approved Indicates a PR has been approved by an approver from all required OWNERS files. lgtm Indicates that a PR is ready to be merged. size/S Denotes a PR that changes 10-29 lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants