Use full display names instead of acronyms in distro JSON files (dotnet#10324)

richlander · Copilot · web-flow · commit d5319520617c · 2026-03-25T09:22:19.000-07:00
Replace RHEL with Red Hat Enterprise Linux and SLES with SUSE Linux
Enterprise Server in all distro JSON files (10.0 and 11.0) including
index.json entries and per-release names.

Update the update-distro-packages skill with display name rules to
prevent acronyms from being used in the future.

Co-authored-by: Copilot &lt;223556219+Copilot@users.noreply.github.com&gt;
diff --git a/.github/skills/update-distro-packages/SKILL.md b/.github/skills/update-distro-packages/SKILL.md
@@ -456,3 +456,21 @@ If the query returns a feed name not listed above, ask the user for the registra
 - Debian/Ubuntu/Fedora use: `dotnet-sdk-{major}.{minor}`, `dotnet-runtime-{major}.{minor}`
 - Microsoft is phasing out packages.microsoft.com for Ubuntu 24.04+ and newer Fedora
 - `install_command` uses `{packages}` as a placeholder for the package list
+
+## Display name rules
+
+The `name` fields (both top-level distro name and per-release names) must use full display names, **never acronyms**. These names appear in generated markdown and user-facing documentation.
+
+| ❌ Acronym | ✅ Full display name |
+|-----------|----------------------|
+| RHEL | Red Hat Enterprise Linux |
+| SLES | SUSE Linux Enterprise Server |
+
+**Examples:**
+
+- Top-level: `"name": "Red Hat Enterprise Linux"` (not `"RHEL"`)
+- Release: `"name": "Red Hat Enterprise Linux 9"` (not `"RHEL 9"`)
+- Top-level: `"name": "SUSE Linux Enterprise Server"` (not `"SLES"`)
+- Release: `"name": "SUSE Linux Enterprise Server 15.7"` (not `"SLES 15.7"`)
+
+File names (`rhel.json`, `sles.json`) remain short — only the `name` fields inside must use full names. When creating new distro files or adding releases, always verify the display name is the full product name, not an abbreviation.
diff --git a/release-notes/10.0/distros/index.json b/release-notes/10.0/distros/index.json
@@ -11,8 +11,8 @@
     "homebrew.json": "Homebrew",
     "nixos.json": "NixOS",
     "opensuse_leap.json": "openSUSE Leap",
-    "rhel.json": "RHEL",
-    "sles.json": "SLES",
+    "rhel.json": "Red Hat Enterprise Linux",
+    "sles.json": "SUSE Linux Enterprise Server",
     "ubuntu.json": "Ubuntu"
   }
 }
diff --git a/release-notes/10.0/distros/rhel.json b/release-notes/10.0/distros/rhel.json
@@ -1,9 +1,9 @@
 {
-  "name": "RHEL",
+  "name": "Red Hat Enterprise Linux",
   "install_command": "dnf install -y {packages}",
   "releases": [
     {
-      "name": "RHEL 10",
+      "name": "Red Hat Enterprise Linux 10",
       "release": "10",
       "dependencies": [
         {
@@ -55,7 +55,7 @@
       ]
     },
     {
-      "name": "RHEL 9",
+      "name": "Red Hat Enterprise Linux 9",
       "release": "9",
       "dependencies": [
         {
@@ -107,7 +107,7 @@
       ]
     },
     {
-      "name": "RHEL 8",
+      "name": "Red Hat Enterprise Linux 8",
       "release": "8",
       "dependencies": [
         {
diff --git a/release-notes/10.0/distros/sles.json b/release-notes/10.0/distros/sles.json
@@ -1,9 +1,9 @@
 {
-  "name": "SLES",
+  "name": "SUSE Linux Enterprise Server",
   "install_command": "zypper install -y {packages}",
   "releases": [
     {
-      "name": "SLES 16.0",
+      "name": "SUSE Linux Enterprise Server 16.0",
       "release": "16.0",
       "dependencies": [
         {
@@ -41,7 +41,7 @@
       ]
     },
     {
-      "name": "SLES 15.7",
+      "name": "SUSE Linux Enterprise Server 15.7",
       "release": "15.7",
       "dependencies": [
         {
@@ -79,7 +79,7 @@
       ]
     },
     {
-      "name": "SLES 15.6",
+      "name": "SUSE Linux Enterprise Server 15.6",
       "release": "15.6",
       "dependencies": [
         {
diff --git a/release-notes/11.0/distros/index.json b/release-notes/11.0/distros/index.json
@@ -8,8 +8,8 @@
     "fedora.json": "Fedora",
     "freebsd.json": "FreeBSD",
     "opensuse_leap.json": "openSUSE Leap",
-    "rhel.json": "RHEL",
-    "sles.json": "SLES",
+    "rhel.json": "Red Hat Enterprise Linux",
+    "sles.json": "SUSE Linux Enterprise Server",
     "ubuntu.json": "Ubuntu"
   }
 }
diff --git a/release-notes/11.0/distros/rhel.json b/release-notes/11.0/distros/rhel.json
@@ -1,9 +1,9 @@
 {
-  "name": "RHEL",
+  "name": "Red Hat Enterprise Linux",
   "install_command": "dnf install -y {packages}",
   "releases": [
     {
-      "name": "RHEL 10",
+      "name": "Red Hat Enterprise Linux 10",
       "release": "10",
       "dependencies": [
         {
@@ -41,7 +41,7 @@
       ]
     },
     {
-      "name": "RHEL 9",
+      "name": "Red Hat Enterprise Linux 9",
       "release": "9",
       "dependencies": [
         {
@@ -79,7 +79,7 @@
       ]
     },
     {
-      "name": "RHEL 8",
+      "name": "Red Hat Enterprise Linux 8",
       "release": "8",
       "dependencies": [
         {
diff --git a/release-notes/11.0/distros/sles.json b/release-notes/11.0/distros/sles.json
@@ -1,9 +1,9 @@
 {
-  "name": "SLES",
+  "name": "SUSE Linux Enterprise Server",
   "install_command": "zypper install -y {packages}",
   "releases": [
     {
-      "name": "SLES 16.0",
+      "name": "SUSE Linux Enterprise Server 16.0",
       "release": "16.0",
       "dependencies": [
         {
@@ -41,7 +41,7 @@
       ]
     },
     {
-      "name": "SLES 15.7",
+      "name": "SUSE Linux Enterprise Server 15.7",
       "release": "15.7",
       "dependencies": [
         {
@@ -79,7 +79,7 @@
       ]
     },
     {
-      "name": "SLES 15.6",
+      "name": "SUSE Linux Enterprise Server 15.6",
       "release": "15.6",
       "dependencies": [
         {

Original file line number	Diff line number	Diff line change
`@@ -11,8 +11,8 @@`
`11`	`11`	`"homebrew.json": "Homebrew",`
`12`	`12`	`"nixos.json": "NixOS",`
`13`	`13`	`"opensuse_leap.json": "openSUSE Leap",`
`14`		`- "rhel.json": "RHEL",`
`15`		`- "sles.json": "SLES",`
	`14`	`+ "rhel.json": "Red Hat Enterprise Linux",`
	`15`	`+ "sles.json": "SUSE Linux Enterprise Server",`
`16`	`16`	`"ubuntu.json": "Ubuntu"`
`17`	`17`	`}`
`18`	`18`	`}`
Original file line number	Diff line number	Diff line change
`@@ -1,9 +1,9 @@`
`1`	`1`	`{`
`2`		`- "name": "RHEL",`
	`2`	`+ "name": "Red Hat Enterprise Linux",`
`3`	`3`	`"install_command": "dnf install -y {packages}",`
`4`	`4`	`"releases": [`
`5`	`5`	`{`
`6`		`- "name": "RHEL 10",`
	`6`	`+ "name": "Red Hat Enterprise Linux 10",`
`7`	`7`	`"release": "10",`
`8`	`8`	`"dependencies": [`
`9`	`9`	`{`
`@@ -55,7 +55,7 @@`
`55`	`55`	`]`
`56`	`56`	`},`
`57`	`57`	`{`
`58`		`- "name": "RHEL 9",`
	`58`	`+ "name": "Red Hat Enterprise Linux 9",`
`59`	`59`	`"release": "9",`
`60`	`60`	`"dependencies": [`
`61`	`61`	`{`
`@@ -107,7 +107,7 @@`
`107`	`107`	`]`
`108`	`108`	`},`
`109`	`109`	`{`
`110`		`- "name": "RHEL 8",`
	`110`	`+ "name": "Red Hat Enterprise Linux 8",`
`111`	`111`	`"release": "8",`
`112`	`112`	`"dependencies": [`
`113`	`113`	`{`
Original file line number	Diff line number	Diff line change
`@@ -1,9 +1,9 @@`
`1`	`1`	`{`
`2`		`- "name": "SLES",`
	`2`	`+ "name": "SUSE Linux Enterprise Server",`
`3`	`3`	`"install_command": "zypper install -y {packages}",`
`4`	`4`	`"releases": [`
`5`	`5`	`{`
`6`		`- "name": "SLES 16.0",`
	`6`	`+ "name": "SUSE Linux Enterprise Server 16.0",`
`7`	`7`	`"release": "16.0",`
`8`	`8`	`"dependencies": [`
`9`	`9`	`{`
`@@ -41,7 +41,7 @@`
`41`	`41`	`]`
`42`	`42`	`},`
`43`	`43`	`{`
`44`		`- "name": "SLES 15.7",`
	`44`	`+ "name": "SUSE Linux Enterprise Server 15.7",`
`45`	`45`	`"release": "15.7",`
`46`	`46`	`"dependencies": [`
`47`	`47`	`{`
`@@ -79,7 +79,7 @@`
`79`	`79`	`]`
`80`	`80`	`},`
`81`	`81`	`{`
`82`		`- "name": "SLES 15.6",`
	`82`	`+ "name": "SUSE Linux Enterprise Server 15.6",`
`83`	`83`	`"release": "15.6",`
`84`	`84`	`"dependencies": [`
`85`	`85`	`{`
Original file line number	Diff line number	Diff line change
`@@ -8,8 +8,8 @@`
`8`	`8`	`"fedora.json": "Fedora",`
`9`	`9`	`"freebsd.json": "FreeBSD",`
`10`	`10`	`"opensuse_leap.json": "openSUSE Leap",`
`11`		`- "rhel.json": "RHEL",`
`12`		`- "sles.json": "SLES",`
	`11`	`+ "rhel.json": "Red Hat Enterprise Linux",`
	`12`	`+ "sles.json": "SUSE Linux Enterprise Server",`
`13`	`13`	`"ubuntu.json": "Ubuntu"`
`14`	`14`	`}`
`15`	`15`	`}`