Skip to content

Add per-distro package files and update-distro-packages skill for 11.0#10322

Merged
richlander merged 12 commits intomainfrom
distro-packages-11.0
Mar 25, 2026
Merged

Add per-distro package files and update-distro-packages skill for 11.0#10322
richlander merged 12 commits intomainfrom
distro-packages-11.0

Conversation

@richlander
Copy link
Copy Markdown
Member

Summary

Replaces the monolithic os-packages.json for .NET 11.0 with per-distro files in release-notes/11.0/distros/, and adds a Copilot skill to maintain them.

Changes

Remove legacy format

  • Delete release-notes/11.0/os-packages.json and os-packages.md

Add release-notes/11.0/distros/

  • dependencies.json — distro-agnostic dependency list (extracted from os-packages.json)
  • index.json — file listing
  • 10 per-distro files: Alpine, Azure Linux, CentOS Stream, Debian, Fedora, FreeBSD, openSUSE Leap, RHEL, SLES, Ubuntu

Each per-distro file is scoped to .NET 11.0 and contains:

  • install_command — how to install packages on the distro
  • releases[] — per-release dependency mappings (id → distro-specific package name)

Add update-distro-packages skill

  • .github/skills/update-distro-packages/SKILL.md — documents the schema, creation process, and update workflows

Design

Files are version-scoped: release-notes/11.0/distros/ubuntu.json answers "what does .NET 11.0 need on Ubuntu?". No dotnet_versions field — the version is the parent directory. dotnet_packages fields will be populated later via the query tool.

richlander and others added 3 commits March 24, 2026 16:52
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
richlander and others added 5 commits March 24, 2026 17:17
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Adds instructions for querying pkgs.org and mapping results into
dotnet_packages/dotnet_packages_other fields in per-distro files.
Skill now asks user for PKGS_ORG_TOKEN when package updates are needed.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copy link
Copy Markdown
Member Author

@richlander richlander left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The skill documents dotnet_packages_other.backports with an install_command field, but the example value is a placeholder comment:

"install_command": "# See Ubuntu backports PPA documentation"

This should be an actual command that users can run to register the feed, e.g.:

"register_command": "sudo add-apt-repository ppa:dotnet/backports"

Without this, the generated markdown for Ubuntu 22.04 will list .NET packages but give users no way to actually install them — apt-get install dotnet-sdk-10.0 will fail with "package not found."

The field name register_command (separate from install_command) may be clearer since it is a one-time setup step, not the install itself.

richlander and others added 4 commits March 24, 2026 21:15
Document exact install_command values for Ubuntu backports PPA and
Microsoft PMC. Clarify that install_command is required for every
dotnet_packages_other entry — it tells users how to register the
feed before installing packages.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Document querying distro package lists directly (e.g.
packages.ubuntu.com) as a fallback when pkgs.org doesn't have
data for newly released distro versions.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Document querying Fedora's Bodhi update system and source RPM
specs to check package availability for new Fedora releases
when pkgs.org doesn't have data yet.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@richlander richlander merged commit 3d1f57d into main Mar 25, 2026
7 of 8 checks passed
@richlander richlander deleted the distro-packages-11.0 branch March 25, 2026 15:49
- **.NET version** — which version to work on (e.g. "11.0")
- **Task** — what to do: create new distros/ directory, add a distro release, update package names, populate dotnet packages, etc.

Ask the user: **Do you want to update dotnet packages (which .NET packages are available in each distro)?** If so, ask them to provide or set `PKGS_ORG_TOKEN`. This requires a [pkgs.org Gold+ subscription](https://pkgs.org/about/).
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@richlander - are we expecting anyone who runs this tool have a Gold+ membership or has a team membership been explored?

"fedora.json": "Fedora",
"freebsd.json": "FreeBSD",
"opensuse_leap.json": "openSUSE Leap",
"rhel.json": "RHEL",
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Inconsistent to use abbreviations for SUSE Linux Enterprise Server and Red Hat Enterprise Linux?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants