Reworked based on review feedback

thompson-tomo · thompson-tomo · commit 61a508e089f7 · 2025-07-08T20:53:44.000+10:00
diff --git a/docs/registry/attributes/os.md b/docs/registry/attributes/os.md
@@ -12,7 +12,7 @@ The operating system (OS) on which the process represented by this resource is r
 | <a id="os-build-id" href="#os-build-id">`os.build_id`</a> | string | Unique identifier for a particular build or compilation of the operating system. | `TQ3C.230805.001.B2`; `20E247`; `22621` | ![Development](https://img.shields.io/badge/-development-blue) |
 | <a id="os-description" href="#os-description">`os.description`</a> | string | Human readable (not intended to be parsed) OS version information, like e.g. reported by `ver` or `lsb_release -a` commands. | `Microsoft Windows [Version 10.0.18363.778]`; `Ubuntu 18.04.1 LTS` | ![Development](https://img.shields.io/badge/-development-blue) |
 | <a id="os-name" href="#os-name">`os.name`</a> | string | Human readable operating system name. | `iOS`; `Android`; `Ubuntu` | ![Development](https://img.shields.io/badge/-development-blue) |
-| <a id="os-type" href="#os-type">`os.type`</a> | string | The operating system type. | `windows`; `linux`; `darwin` | ![Development](https://img.shields.io/badge/-development-blue) |
+| <a id="os-type" href="#os-type">`os.type`</a> | string | The operating system type. | `windows`; `linux`; `unix` | ![Development](https://img.shields.io/badge/-development-blue) |
 | <a id="os-version" href="#os-version">`os.version`</a> | string | The version string of the operating system as defined in [Version Attributes](/docs/resource/README.md#version-attributes). | `14.2.1`; `18.04.1` | ![Development](https://img.shields.io/badge/-development-blue) |
 
 ---
@@ -21,26 +21,5 @@ The operating system (OS) on which the process represented by this resource is r
 
 | Value  | Description | Stability |
 |---|---|---|
-| `aix` | AIX (Advanced Interactive eXecutive) | ![Development](https://img.shields.io/badge/-development-blue) |
-| `android` | Android | ![Development](https://img.shields.io/badge/-development-blue) |
-| `archlinux` | Arch Linux | ![Development](https://img.shields.io/badge/-development-blue) |
-| `centos` | CentOS | ![Development](https://img.shields.io/badge/-development-blue) |
-| `chromeos` | ChromeOS | ![Development](https://img.shields.io/badge/-development-blue) |
-| `chromiumos` | ChromiumOS | ![Development](https://img.shields.io/badge/-development-blue) |
-| `dragonflybsd` | DragonFly BSD | ![Development](https://img.shields.io/badge/-development-blue) |
-| `fireos` | Fire OS | ![Development](https://img.shields.io/badge/-development-blue) |
-| `freebsd` | FreeBSD | ![Development](https://img.shields.io/badge/-development-blue) |
-| `hpux` | HP-UX (Hewlett Packard Unix) | ![Development](https://img.shields.io/badge/-development-blue) |
-| `ios` | Apple ios | ![Development](https://img.shields.io/badge/-development-blue) |
-| `manjaro` | Manjaro | ![Development](https://img.shields.io/badge/-development-blue) |
-| `netbsd` | NetBSD | ![Development](https://img.shields.io/badge/-development-blue) |
-| `openbsd` | OpenBSD | ![Development](https://img.shields.io/badge/-development-blue) |
-| `rhel` | Red Hat Enterprise Linux | ![Development](https://img.shields.io/badge/-development-blue) |
-| `solaris` | SunOS, Oracle Solaris | ![Development](https://img.shields.io/badge/-development-blue) |
-| `steamos` | SteamOS | ![Development](https://img.shields.io/badge/-development-blue) |
-| `suse` | SUSE Linux Enterprise | ![Development](https://img.shields.io/badge/-development-blue) |
-| `tvos` | Apple tvos | ![Development](https://img.shields.io/badge/-development-blue) |
-| `ubuntu` | Ubuntu | ![Development](https://img.shields.io/badge/-development-blue) |
-| `watchos` | Apple WatchOS | ![Development](https://img.shields.io/badge/-development-blue) |
+| `unix` | Unix | ![Development](https://img.shields.io/badge/-development-blue) |
 | `windows` | Microsoft Windows | ![Development](https://img.shields.io/badge/-development-blue) |
-| `zos` | IBM z/OS | ![Development](https://img.shields.io/badge/-development-blue) |
diff --git a/docs/registry/entities/os.md b/docs/registry/entities/os.md
@@ -20,7 +20,7 @@
 
 | Attribute  | Type | Description  | Examples  | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
 |---|---|---|---|---|---|
-| [`os.type`](/docs/registry/attributes/os.md) | string | The operating system type. | `windows`; `linux`; `darwin` | `Required` | ![Development](https://img.shields.io/badge/-development-blue) |
+| [`os.type`](/docs/registry/attributes/os.md) | string | The operating system type. | `windows`; `linux`; `unix` | `Required` | ![Development](https://img.shields.io/badge/-development-blue) |
 | [`os.build_id`](/docs/registry/attributes/os.md) | string | Unique identifier for a particular build or compilation of the operating system. [1] | `TQ3C.230805.001.B2`; `20E247`; `22621` | `Recommended` | ![Development](https://img.shields.io/badge/-development-blue) |
 | [`os.description`](/docs/registry/attributes/os.md) | string | Human readable (not intended to be parsed) OS version information, like e.g. reported by `ver` or `lsb_release -a` commands. | `Microsoft Windows [Version 10.0.18363.778]`; `Ubuntu 18.04.1 LTS` | `Recommended` | ![Development](https://img.shields.io/badge/-development-blue) |
 | [`os.name`](/docs/registry/attributes/os.md) | string | Human readable operating system name. | `iOS`; `Android`; `Ubuntu` | `Recommended` | ![Development](https://img.shields.io/badge/-development-blue) |
@@ -40,29 +40,8 @@
 
 | Value  | Description | Stability |
 |---|---|---|
-| `aix` | AIX (Advanced Interactive eXecutive) | ![Development](https://img.shields.io/badge/-development-blue) |
-| `android` | Android | ![Development](https://img.shields.io/badge/-development-blue) |
-| `archlinux` | Arch Linux | ![Development](https://img.shields.io/badge/-development-blue) |
-| `centos` | CentOS | ![Development](https://img.shields.io/badge/-development-blue) |
-| `chromeos` | ChromeOS | ![Development](https://img.shields.io/badge/-development-blue) |
-| `chromiumos` | ChromiumOS | ![Development](https://img.shields.io/badge/-development-blue) |
-| `dragonflybsd` | DragonFly BSD | ![Development](https://img.shields.io/badge/-development-blue) |
-| `fireos` | Fire OS | ![Development](https://img.shields.io/badge/-development-blue) |
-| `freebsd` | FreeBSD | ![Development](https://img.shields.io/badge/-development-blue) |
-| `hpux` | HP-UX (Hewlett Packard Unix) | ![Development](https://img.shields.io/badge/-development-blue) |
-| `ios` | Apple ios | ![Development](https://img.shields.io/badge/-development-blue) |
-| `manjaro` | Manjaro | ![Development](https://img.shields.io/badge/-development-blue) |
-| `netbsd` | NetBSD | ![Development](https://img.shields.io/badge/-development-blue) |
-| `openbsd` | OpenBSD | ![Development](https://img.shields.io/badge/-development-blue) |
-| `rhel` | Red Hat Enterprise Linux | ![Development](https://img.shields.io/badge/-development-blue) |
-| `solaris` | SunOS, Oracle Solaris | ![Development](https://img.shields.io/badge/-development-blue) |
-| `steamos` | SteamOS | ![Development](https://img.shields.io/badge/-development-blue) |
-| `suse` | SUSE Linux Enterprise | ![Development](https://img.shields.io/badge/-development-blue) |
-| `tvos` | Apple tvos | ![Development](https://img.shields.io/badge/-development-blue) |
-| `ubuntu` | Ubuntu | ![Development](https://img.shields.io/badge/-development-blue) |
-| `watchos` | Apple WatchOS | ![Development](https://img.shields.io/badge/-development-blue) |
+| `unix` | Unix | ![Development](https://img.shields.io/badge/-development-blue) |
 | `windows` | Microsoft Windows | ![Development](https://img.shields.io/badge/-development-blue) |
-| `zos` | IBM z/OS | ![Development](https://img.shields.io/badge/-development-blue) |
 
 
 <!-- markdownlint-restore -->
diff --git a/docs/resource/os.md b/docs/resource/os.md
@@ -18,7 +18,7 @@ In case of virtualized environments, this is the operating system as it is obser
 
 | Attribute  | Type | Description  | Examples  | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
 |---|---|---|---|---|---|
-| [`os.type`](/docs/registry/attributes/os.md) | string | The operating system type. | `windows`; `linux`; `darwin` | `Required` | ![Development](https://img.shields.io/badge/-development-blue) |
+| [`os.type`](/docs/registry/attributes/os.md) | string | The operating system type. | `windows`; `linux`; `unix` | `Required` | ![Development](https://img.shields.io/badge/-development-blue) |
 | [`os.build_id`](/docs/registry/attributes/os.md) | string | Unique identifier for a particular build or compilation of the operating system. [1] | `TQ3C.230805.001.B2`; `20E247`; `22621` | `Recommended` | ![Development](https://img.shields.io/badge/-development-blue) |
 | [`os.description`](/docs/registry/attributes/os.md) | string | Human readable (not intended to be parsed) OS version information, like e.g. reported by `ver` or `lsb_release -a` commands. | `Microsoft Windows [Version 10.0.18363.778]`; `Ubuntu 18.04.1 LTS` | `Recommended` | ![Development](https://img.shields.io/badge/-development-blue) |
 | [`os.name`](/docs/registry/attributes/os.md) | string | Human readable operating system name. | `iOS`; `Android`; `Ubuntu` | `Recommended` | ![Development](https://img.shields.io/badge/-development-blue) |
@@ -38,29 +38,8 @@ In case of virtualized environments, this is the operating system as it is obser
 
 | Value  | Description | Stability |
 |---|---|---|
-| `aix` | AIX (Advanced Interactive eXecutive) | ![Development](https://img.shields.io/badge/-development-blue) |
-| `android` | Android | ![Development](https://img.shields.io/badge/-development-blue) |
-| `archlinux` | Arch Linux | ![Development](https://img.shields.io/badge/-development-blue) |
-| `centos` | CentOS | ![Development](https://img.shields.io/badge/-development-blue) |
-| `chromeos` | ChromeOS | ![Development](https://img.shields.io/badge/-development-blue) |
-| `chromiumos` | ChromiumOS | ![Development](https://img.shields.io/badge/-development-blue) |
-| `dragonflybsd` | DragonFly BSD | ![Development](https://img.shields.io/badge/-development-blue) |
-| `fireos` | Fire OS | ![Development](https://img.shields.io/badge/-development-blue) |
-| `freebsd` | FreeBSD | ![Development](https://img.shields.io/badge/-development-blue) |
-| `hpux` | HP-UX (Hewlett Packard Unix) | ![Development](https://img.shields.io/badge/-development-blue) |
-| `ios` | Apple ios | ![Development](https://img.shields.io/badge/-development-blue) |
-| `manjaro` | Manjaro | ![Development](https://img.shields.io/badge/-development-blue) |
-| `netbsd` | NetBSD | ![Development](https://img.shields.io/badge/-development-blue) |
-| `openbsd` | OpenBSD | ![Development](https://img.shields.io/badge/-development-blue) |
-| `rhel` | Red Hat Enterprise Linux | ![Development](https://img.shields.io/badge/-development-blue) |
-| `solaris` | SunOS, Oracle Solaris | ![Development](https://img.shields.io/badge/-development-blue) |
-| `steamos` | SteamOS | ![Development](https://img.shields.io/badge/-development-blue) |
-| `suse` | SUSE Linux Enterprise | ![Development](https://img.shields.io/badge/-development-blue) |
-| `tvos` | Apple tvos | ![Development](https://img.shields.io/badge/-development-blue) |
-| `ubuntu` | Ubuntu | ![Development](https://img.shields.io/badge/-development-blue) |
-| `watchos` | Apple WatchOS | ![Development](https://img.shields.io/badge/-development-blue) |
+| `unix` | Unix | ![Development](https://img.shields.io/badge/-development-blue) |
 | `windows` | Microsoft Windows | ![Development](https://img.shields.io/badge/-development-blue) |
-| `zos` | IBM z/OS | ![Development](https://img.shields.io/badge/-development-blue) |
 
 <!-- markdownlint-restore -->
 <!-- prettier-ignore-end -->
diff --git a/docs/resource/zos.md b/docs/resource/zos.md
@@ -87,29 +87,8 @@ The following table describes how to populate the operating system attributes on
 
 | Value  | Description | Stability |
 |---|---|---|
-| `aix` | AIX (Advanced Interactive eXecutive) | ![Development](https://img.shields.io/badge/-development-blue) |
-| `android` | Android | ![Development](https://img.shields.io/badge/-development-blue) |
-| `archlinux` | Arch Linux | ![Development](https://img.shields.io/badge/-development-blue) |
-| `centos` | CentOS | ![Development](https://img.shields.io/badge/-development-blue) |
-| `chromeos` | ChromeOS | ![Development](https://img.shields.io/badge/-development-blue) |
-| `chromiumos` | ChromiumOS | ![Development](https://img.shields.io/badge/-development-blue) |
-| `dragonflybsd` | DragonFly BSD | ![Development](https://img.shields.io/badge/-development-blue) |
-| `fireos` | Fire OS | ![Development](https://img.shields.io/badge/-development-blue) |
-| `freebsd` | FreeBSD | ![Development](https://img.shields.io/badge/-development-blue) |
-| `hpux` | HP-UX (Hewlett Packard Unix) | ![Development](https://img.shields.io/badge/-development-blue) |
-| `ios` | Apple ios | ![Development](https://img.shields.io/badge/-development-blue) |
-| `manjaro` | Manjaro | ![Development](https://img.shields.io/badge/-development-blue) |
-| `netbsd` | NetBSD | ![Development](https://img.shields.io/badge/-development-blue) |
-| `openbsd` | OpenBSD | ![Development](https://img.shields.io/badge/-development-blue) |
-| `rhel` | Red Hat Enterprise Linux | ![Development](https://img.shields.io/badge/-development-blue) |
-| `solaris` | SunOS, Oracle Solaris | ![Development](https://img.shields.io/badge/-development-blue) |
-| `steamos` | SteamOS | ![Development](https://img.shields.io/badge/-development-blue) |
-| `suse` | SUSE Linux Enterprise | ![Development](https://img.shields.io/badge/-development-blue) |
-| `tvos` | Apple tvos | ![Development](https://img.shields.io/badge/-development-blue) |
-| `ubuntu` | Ubuntu | ![Development](https://img.shields.io/badge/-development-blue) |
-| `watchos` | Apple WatchOS | ![Development](https://img.shields.io/badge/-development-blue) |
+| `unix` | Unix | ![Development](https://img.shields.io/badge/-development-blue) |
 | `windows` | Microsoft Windows | ![Development](https://img.shields.io/badge/-development-blue) |
-| `zos` | IBM z/OS | ![Development](https://img.shields.io/badge/-development-blue) |
 
 <!-- markdownlint-restore -->
 <!-- prettier-ignore-end -->
diff --git a/model/os/registry.yaml b/model/os/registry.yaml
@@ -11,47 +11,58 @@ groups:
       - id: os.type
         type:
           members:
-            - id: windows
+            - id: windowsnt
               value: 'windows'
               brief: "Microsoft Windows"
               stability: development
             - id: linux
               value: 'linux'
               brief: "Linux"
-              deprecated: Should be set as the `os.family` instead
+              deprecated: Should use `unix` instead'
+              stability: development
+            - id: unix
+              value: 'unix'
+              brief: "Unix"
               stability: development
             - id: darwin
               value: 'darwin'
               brief: "Apple Darwin"
-              deprecated: Should be set as the `os.classifcation` instead.
+              deprecated: Should be set as the `os.family` instead.
               stability: development
             - id: freebsd
               value: 'freebsd'
               brief: "FreeBSD"
+              deprecated: "Use `os.name` instead"
               stability: development
             - id: netbsd
               value: 'netbsd'
               brief: "NetBSD"
+              deprecated: "Use `os.name` instead"
               stability: development
             - id: openbsd
               value: 'openbsd'
               brief: "OpenBSD"
+              deprecated: "Use `os.name` instead"
               stability: development
             - id: dragonflybsd
               value: 'dragonflybsd'
               brief: "DragonFly BSD"
+              deprecated: "Use `os.name` instead"
               stability: development
             - id: hpux
               value: 'hpux'
               brief: "HP-UX (Hewlett Packard Unix)"
+              deprecated: "Use `os.name` instead"
               stability: development
             - id: aix
               value: 'aix'
               brief: "AIX (Advanced Interactive eXecutive)"
+              deprecated: "Use `os.name` instead"
               stability: development
             - id: solaris
               value: 'solaris'
               brief: "SunOS, Oracle Solaris"
+              deprecated: "Use `os.name` instead"
               stability: development
             - id: z_os
               value: 'z_os'
@@ -61,62 +72,7 @@ groups:
             - id: zos
               value: 'zos'
               brief: "IBM z/OS"
-              stability: development
-            - id: android
-              value: 'android'
-              brief: "Android"
-              stability: development
-            - id: ios
-              value: 'ios'
-              brief: "Apple ios"
-              stability: development
-            - id: tvos
-              value: 'tvos'
-              brief: "Apple tvos"
-              stability: development
-            - id: watchos
-              value: 'watchos'
-              brief: "Apple WatchOS"
-              stability: development
-            - id: ubuntu
-              value: 'ubuntu'
-              brief: "Ubuntu"
-              stability: development
-            - id: manjaro
-              value: 'manjaro'
-              brief: "Manjaro"
-              stability: development
-            - id: steamos
-              value: 'steamos'
-              brief: "SteamOS"
-              stability: development
-            - id: centos
-              value: 'centos'
-              brief: "CentOS"
-              stability: development
-            - id: archlinux
-              value: 'archlinux'
-              brief: "Arch Linux"
-              stability: development
-            - id: rhel
-              value: 'rhel'
-              brief: "Red Hat Enterprise Linux "
-              stability: development
-            - id: suse
-              value: 'suse'
-              brief: "SUSE Linux Enterprise"
-              stability: development
-            - id: chromeos
-              value: 'chromeos'
-              brief: "ChromeOS"
-              stability: development
-            - id: chromiumos
-              value: 'chromiumos'
-              brief: "ChromiumOS"
-              stability: development
-            - id: fireos
-              value: 'fireos'
-              brief: "Fire OS"
+              deprecated: "Use `os.name` instead"
               stability: development
         brief: >
           The operating system type.
