Skip to content

DOCS-6612 Add prep-changelog skill proposal - #1047

Open
dbart wants to merge 2 commits into
mainfrom
DOCS-6612-prep-changelog-proposal
Open

dbart wants to merge 2 commits into
mainfrom
DOCS-6612-prep-changelog-proposal

Conversation

@dbart

@dbart dbart commented Sep 8, 2026

Copy link
Copy Markdown
Collaborator

Proposal for a prep-changelog skill. Discussion-first — no skill code.

Ticket: https://mariadbcorp.atlassian.net/browse/DOCS-6612

dbart and others added 2 commits September 8, 2026 17:32
Proposes a skill that turns a Community Server release TODO ticket into
the changelog page, wrapping mariadb.org-tools/release/prep-changelog.
Today the script is run by hand and its output pasted into a
pre-prepared page, which is manual enough to invite errors -- notably
the -m and -x arguments, which are not on the TODO ticket and have to be
derived.

Discussion-first: this PR is the proposal only, no skill code.

Alternatives considered is left as TBD.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Records the four options weighed against a skill: keeping the manual
run-and-paste status quo, growing the shell script, extending
doc-from-ticket, and triggering from a hook or CI job. The status-quo
entry names the three things DOCS-6610 had to get right by hand -- the
undocumented -m and -x arguments, the GitBook escaping the raw output
needs, and the script's unguarded git reset --hard on the shared server
clone.

Completes the proposal; no sections remain TBD.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@mariadb-stefan-hinz mariadb-stefan-hinz added the doc-tools Documentation tools, including Claude skill files etc. label Sep 9, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

doc-tools Documentation tools, including Claude skill files etc.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants