mirror of
https://github.com/jenkinsci/jenkins.git
synced 2026-10-26 19:15:09 +00:00
Remove Jira issue from changelog summary in PR template (#9490)
When the Jira issue is included in the changelog summary, it is included in the generated changelog as the initial text of the changelog entry. The same issue link is then included by the changelog generator at the end of the changelog description. Remove the example that places the issue at the start of the changelog text and explain that the issue link should be elsewhere in the pull request so that the changelog generator can use it. When the Jira issue is included in the changelog summary, the changelog maintainers must remove it before the changelog is published. It is better to not include the Jira issue in the changelog summary so that changelog maintainers do not need to remove it. Remind submitters that they should not delete the upgrade guidelines section because the presence of the upgrade guidelines section is used by the changelog generator as the terminator for the proposed changelog entries.
This commit is contained in:
1 parent
81b90e4c11
commit
cc97ad8f33
1 file changed
+9
-3
@@ -28,16 +28,17 @@ For refactoring and code cleanup changes, exercise the code before and after the
|
||||
|
||||
### Proposed changelog entries
|
||||
|
||||
- JENKINS-XXXXX, human-readable text
|
||||
- human-readable text
|
||||
|
||||
<!-- Comment:
|
||||
The changelog entry should be in the imperative mood; e.g., write "do this"/"return that" rather than "does this"/"returns that".
|
||||
For examples, see: https://www.jenkins.io/changelog/
|
||||
|
||||
Remove JENKINS-XXXXX if there is no issue for the pull request.
|
||||
Do not include the Jira issue in the changelog entry.
|
||||
Include the Jira issue in the description of the pull request so that the changelog generator can find it and include it in the generated changelog.
|
||||
|
||||
You may add multiple changelog entries if applicable by adding a new entry to the list, e.g.
|
||||
- JENKINS-123456, First changelog entry
|
||||
- First changelog entry
|
||||
- Second changelog entry
|
||||
-->
|
||||
|
||||
@@ -45,6 +46,11 @@ You may add multiple changelog entries if applicable by adding a new entry to th
|
||||
|
||||
N/A
|
||||
|
||||
<!-- Comment:
|
||||
Leave the proposed upgrade guidelines in the pull request with the "N/A" value if no upgrade guidelines are needed.
|
||||
The changelog generator relies on the presence of the upgrade guidelines section as part of its data extraction process.
|
||||
-->
|
||||
|
||||
```[tasklist]
|
||||
### Submitter checklist
|
||||
- [ ] The Jira issue, if it exists, is well-described.
|
||||
|
||||
Reference in new issue
Block a user