| name | changelog |
| description | Create a changelog entry for Unity Timeline by asking for bug number, change type, and description |
| disable-model-invocation | false |
Changelog Entry Creator
Create changelog entries in .changelogs/ following Unity Timeline's release notes guidelines.
Process
-
Ask for issue number (use AskUserQuestion):
- Options: "I have a UUM/JIRA number" | "I have an issue ID" | "No issue number"
-
Ask for change type (use AskUserQuestion):
- Added: New features, new APIs
- Changed: Changed behavior, API changes, obsolete APIs
- Fixed: Bugfixes
- Internal: Changes only impacting internal tools/APIs
-
Ask for description: For bugfixes, write from user's perspective (not too technical - release notes are for users first). Don't copy bug titles verbatim.
-
Generate filename: [UUM-####|####]-<ShortDescription>.md
- ShortDescription: 2-4 words, CamelCase, descriptive
- Good:
UUM-1234567-RectangleSelectionFix.md, Bad: TimelineFix.md
-
Create file in .changelogs/<filename>.md:
<ChangeType>
- <Description> ([<JIRA_ID>](LINK))
- Fixed: Use Issue Tracker link:
https://issuetracker.unity3d.com/product/unity/issues/guid/<JIRA_ID>
- Internal: Use JIRA link:
https://jira.unity3d.com/browse/<JIRA_ID>
- Multiple entries per file allowed (don't reuse across branches)
-
Confirm with user where file was created and remind to commit with changes.
Examples
.changelogs/TrackImprovements.md
Added
- Inline Curve Properties can be removed.
- Tracks can be individually resized.
.changelogs/AnimationCurveFixes.md
Fixed
- Fixed preview of Avatar Masks on base level Animation Tracks. ([1190600](https://issuetracker.unity3d.com/product/unity/issues/guid/1190600/))
.changelogs/UUM-131061-DomainReloadHandling.md
Internal
- Fixed Project Auditor warnings about domain reload handling. ([UUM-131061](https://jira.unity3d.com/browse/UUM-131061))