mirror of https://github.com/ROCm/ROCm.git synced 2026-01-09 14:48:06 -05:00

Files

Peter Park 34c0266496 6.2.4 release notes: add known/fixed issues (#193 )

* add "for compute workloads" wording for clarity

* add AMDSMI resolved issue

* add dlm known issue

intro text

wording

* update wording

rm bullet point

update wording

* fix spellcheck due to spacing

* rm s

* rm gfx1151

* remove dlm known issue

* update list of updated docs; note for Radeon users

fmt

* update GA date for 6.2.4

* fix rdc version

2024-11-06 12:42:55 -05:00

templates

6.2.4 release notes: add known/fixed issues (#193 )

2024-11-06 12:42:55 -05:00

util

Change template factory to account for build or revision number (#3474 )

2024-08-02 16:03:03 -06:00

.gitignore

Modify AutoTag to generate changelog (#2004 )

2023-04-14 07:11:08 -06:00

compile_changelogs.sh

Update github links to ROCm organization

2024-02-09 17:03:40 +01:00

components.xml

Sync change from ROCm to ROCm-internal (#194 )

2024-10-25 14:41:40 -04:00

README.md

Sync develop branch

2024-09-19 14:08:10 -06:00

requirements.txt

Modify AutoTag to generate changelog (#2004 )

2023-04-14 07:11:08 -06:00

tag_script.py

Add starting-versions flag to autotag script (#3730 )

2024-09-17 10:13:28 -06:00

README.md

Autotag

Pre-requisites

Python 3.10
Create a GitHub Personal Access Token.
- Tested with all the read-only permissions, but public_repo, read:project read:user, and repo:status should be enough.
- Copy the token somewhere safe.
Configure SSO for this token by authorizing it for the following organizations:
- ROCm-Developer-Tools
- RadeonOpenCompute
- ROCmSoftwarePlatform

Updating the changelog and release notes

IMPORTANT: It is key to update the template Markdown files in tools/autotag/templates/<name of change type> (eg: 5.6.0.md) and not the CHANGELOG.md or RELEASE.md itself to ensure that updates are not overwritten by the autotag script. The template should only have content from changelogs that are not included by the script to avoid duplicating data.

Add or update the release specific notes in tools/autotag/templates/<name of change type>
Ensure the all the repositories have their release specific branch with the updated changelogs
Run this for 5.6.0 (change for whatever version you require)
GITHUB_ACCESS_TOKEN=my_token_here

To generate the changelog from 5.0.0 up to and including 6.2.0:

python3 tag_script.py -t $GITHUB_ACCESS_TOKEN --no-release --no-pulls --starting-version=5.0.0 --compile_file ../../CHANGELOG.md --branch release/rocm-rel-6.2 6.2.0

To generate the release notes only for 6.2.0:

python3 tag_script.py -t $GITHUB_ACCESS_TOKEN --no-release --no-pulls --compile_file ../../RELEASE.md --branch release/rocm-rel-6.2 6.2.0

Notes

If branch cannot be found, edit default.xml at root. Sometimes the script doesn't know whether to include or exclude an entry for a specific release. Continue this part by accepting (Y) or rejecting (N) entries. The end result should be a newly generated changelog in the project root. If the --starting-version flag is not set, the script will not get changelogs from previous versions. Trying to run without a token is possible but GitHub enforces stricter rate limits and is therefore not advised.

Copy over the first part of the changelog and replace the old release notes in RELEASE.md.

Adding new libraries/repositories

Add the name or group of the repository (retrieved in default.xml in the ROCm project root) to: included_names or included_groups to auto_tag.py.
At the moment of writing, this is only in the 5.6 branch and not the develop branch.
Re-run the command specified in the steps above.
Some libraries do not have the changelog for every point release. The tool will give out warnings, but it is okay to ignore them.