Branch: refs/heads/release-documentation-skill Home: https://github.com/xwiki/xwiki-dev-llm Commit: ab3c72854195feb9044267285b488ea9815edc41 https://github.com/xwiki/xwiki-dev-llm/commit/ab3c72854195feb9044267285b488e... Author: Vincent Massol <[email protected]> Date: 2026-09-10 (Thu, 10 Sep 2026) Changed paths: M README.md M xwiki/instructions/xwiki-org.md M xwiki/okf/index.md A xwiki/okf/processes/release-notes.md M xwiki/okf/servers/jira.md M xwiki/skills/xwiki-contrib-release-blog-post/SKILL.md M xwiki/skills/xwiki-doc-convert/SKILL.md M xwiki/skills/xwiki-doc-writing/SKILL.md M xwiki/skills/xwiki-jira/SKILL.md A xwiki/skills/xwiki-release-documentation/SKILL.md Log Message: ----------- Add the xwiki-release-documentation skill, now that the RN endpoints exist The documentation of a release was a manual sweep whose only record was two JIRA fields nobody could query, because the habit of writing "N/A (internal class)" into them means "N/A" does not match. Release Notes Application 2.7 added the REST endpoints that make the other half of it mechanisable: one call creates a release note, one creates a change, and neither leaves an entry half made or two authors racing for the same Entry### number. * Add xwiki/skills/xwiki-release-documentation/SKILL.md, explicit-invocation only, in two modes: a whole Fix Version (the issues the developer fixed in it, across XWIKI/XCOMMONS/XRENDERING) or one named issue. It reads the full diff of every issue including the ones heading for N/A, since an N/A verdict is a claim that has to be proven; traces every written fact to file:line at the release ref; has a fresh verifier check the prose it did not write; and re-derives the existing field values rather than trusting them, which makes the run an audit and not a gap-filler. * Add xwiki/okf/processes/release-notes.md, the declarative half: the page tree a release note is, why entries belong to the RC and not to the final version, the four endpoints with the traps a client has to know (a POST answers the stored value, a duplicate note is a 409, changes are never deduplicated, a listing on a missing note is an empty 200), and how an entry's escaped reference becomes the URL a JIRA field wants. * Record the bare-N/A rule and the two custom field ids in okf/servers/jira.md. Bare N/A is what makes "every fixed issue nobody documented" a query; the reason moves to a comment. * Say in the OKF that the category vocabulary has drifted from the JIRA components it looks like (Blocknote vs BlockNote, LiveData vs Live Data) and give the recipe that harvests it, rather than caching a list that goes stale every cycle. * Point xwiki-doc-writing, xwiki-doc-convert, xwiki-jira and xwiki-contrib-release-blog-post at the new skill, and drop one redundant sentence from xwiki-org.md, which had two bytes of its budget left. Co-Authored-By: Claude Opus 5 (1M context) <[email protected]> To unsubscribe from these emails, change your notification settings at https://github.com/xwiki/xwiki-dev-llm/settings/notifications