Create a Release Note Template
Last modified by Vincent Massol on 2026/08/28 21:31
Steps
A new release note starts as a copy of a template page, whose xobjects are described in Release Note Structure.
- Create a page to hold the template, for example ReleaseNotes.Code.CompactTemplate.
- Enter its title and content, calling $doc.getValue('product') and $doc.getValue('version') wherever the release note's own values belong, and adding the releasenotechanges and releasenotecontributors macros where the changes and the credits should appear.
- Point the "Template Reference" of the configuration at that page, as described in Configure the Release Notes Application.
- Create a release note: its title and content now come from your template, with the product and the version resolved.
FAQ
When are the Velocity expressions of the template evaluated?
Not at creation time. The title and the content are copied verbatim into the new page and evaluated whenever it is rendered, against its own ReleaseNoteClass object.
Can the shipped template be edited instead?
Yes, ReleaseNotes.Code.ReleaseNoteTemplate is declared customizable, so an upgrade of the extension keeps your version of it.
