dotnet / dotnet/core

Grouping for GitHub tag docs? Links to tag docs in release notes?

Open
#9,970 0 comments 0 reactions 0 assignees View on GitHub
area-release-notes
Dominant language
PowerShell
Stars
22k
Forks
4.9k
Avg merge
5d 5h
Merged PRs (30d)
29

Description

### URL(s)

URLs linked in the description below. I'm happy to separately list them here as well; please lmk if this is necessary.

### Description

I was scanning through release notes while updating a project from 9.0.2 to 9.0.7 when I noticed 👀 that,

1. The tag docs for 9.0.6 (e.g., [runtime 9.0.6 tag](https://github.com/dotnet/runtime/releases/tag/v9.0.6), [aspnetcore 9.0.6 tag](https://github.com/dotnet/aspnetcore/releases/tag/v9.0.6), [efcore 9.0.6 tag](https://github.com/dotnet/efcore/releases/tag/v9.0.6)) are grouped into categories (bug fixes, perf improvements, infrastructure, dependency updates, etc.) which made them very easy to scan through 🤩!

This grouping is not present in docs for previous tags (e.g., [runtime 9.0.5 tag](https://github.com/dotnet/runtime/releases/tag/v9.0.5), [aspnetcore 9.0.5 tag](https://github.com/dotnet/aspnetcore/releases/tag/v9.0.5)), and seems have been dropped for 9.0.7 (e.g., [runtime 9.0.7 tag](https://github.com/dotnet/runtime/releases/tag/v9.0.7), [aspnetcore 9.0.7 tag](https://github.com/dotnet/aspnetcore/releases/tag/v9.0.7)). IMO, the ungrouped list is kinda hard to scan through..

**Could the grouping be brought back?**

2. The grouped tag docs of 9.0.6 mention "This summary is generated and may contain inaccuracies" at the end.

![](https://github.com/user-attachments/assets/87df4dac-851a-4aa1-87df-895004dcd36f)

- Does "summary" here refer to the short description of each item (selected text in the screenshot above)?
- ~Also, generated... as in, programmatically using some sort of script that processes issue titles?~ Was the summary AI-generated? Could the grouping be kept (as suggested above) along with links to corresponding GitHub issues, but the **summaries be removed if they're not reviewed for accuracy or potentially inaccurate?**

3. The tag docs link to the corresponding tags of the individual repos (e.g., [core 9.0.7 tag](https://github.com/dotnet/core/releases/tag/v9.0.7) links to [aspnetcore 9.0.7 tag](https://github.com/dotnet/aspnetcore/releases/tag/v9.0.7) and [runtime 9.0.7 tag](https://github.com/dotnet/runtime/releases/tag/v9.0.7)). The release notes (e.g., [core 9.0.7 release note](https://github.com/dotnet/core/blob/main/release-notes/9.0/9.0.7/9.0.7.md)) don't link to the tags.

**Could links to the corresponding dotnet/core tag, or those of the individual repos, be added to release notes?**

Thanks! ✌️

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.