Better link text (#2660)

trask · web-flow · commit 9bc0db95918b · 2025-08-21T13:11:25.000Z
diff --git a/docs/registry/attributes/android.md b/docs/registry/attributes/android.md
@@ -13,7 +13,7 @@ The Android platform on which the Android application is running.
 | Attribute | Type | Description | Examples | Stability |
 |---|---|---|---|---|
 | <a id="android-app-state" href="#android-app-state">`android.app.state`</a> | string | This attribute represents the state of the application. [1] | `created` | ![Development](https://img.shields.io/badge/-development-blue) |
-| <a id="android-os-api-level" href="#android-os-api-level">`android.os.api_level`</a> | string | Uniquely identifies the framework API revision offered by a version (`os.version`) of the android operating system. More information can be found [here](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels). | `33`; `32` | ![Development](https://img.shields.io/badge/-development-blue) |
+| <a id="android-os-api-level" href="#android-os-api-level">`android.os.api_level`</a> | string | Uniquely identifies the framework API revision offered by a version (`os.version`) of the android operating system. More information can be found in the [Android API levels documentation](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels). | `33`; `32` | ![Development](https://img.shields.io/badge/-development-blue) |
 
 **[1] `android.app.state`:** The Android lifecycle states are defined in [Activity lifecycle callbacks](https://developer.android.com/guide/components/activities/activity-lifecycle#lc), and from which the `OS identifiers` are derived.
 
diff --git a/docs/registry/attributes/app.md b/docs/registry/attributes/app.md
@@ -32,7 +32,7 @@ For Android, examples of `app.installation.id` implementations include:
 - [App set ID](https://developer.android.com/identity/app-set-id).
 - [`Settings.getString(Settings.Secure.ANDROID_ID)`](https://developer.android.com/reference/android/provider/Settings.Secure#ANDROID_ID).
 
-More information about Android identifier best practices can be found [here](https://developer.android.com/training/articles/user-data-ids).
+More information about Android identifier best practices can be found in the [Android user data IDs guide](https://developer.android.com/training/articles/user-data-ids).
 
 **[2] `app.widget.id`:** A widget is an application component, typically an on-screen visual GUI element.
 
diff --git a/docs/registry/attributes/device.md b/docs/registry/attributes/device.md
@@ -18,7 +18,7 @@ Describes device attributes.
 However, it might be resettable by the user for all apps on a device.
 Hardware IDs (e.g. vendor-specific serial number, IMEI or MAC address) MAY be used as values.
 
-More information about Android identifier best practices can be found [here](https://developer.android.com/training/articles/user-data-ids).
+More information about Android identifier best practices can be found in the [Android user data IDs guide](https://developer.android.com/training/articles/user-data-ids).
 
 > [!WARNING]
 >
diff --git a/docs/registry/entities/android.md b/docs/registry/entities/android.md
@@ -20,7 +20,7 @@
 
 | Attribute  | Type | Description  | Examples  | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
 |---|---|---|---|---|---|
-| [`android.os.api_level`](/docs/registry/attributes/android.md) | string | Uniquely identifies the framework API revision offered by a version (`os.version`) of the android operating system. More information can be found [here](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels). | `33`; `32` | `Recommended` | ![Development](https://img.shields.io/badge/-development-blue) |
+| [`android.os.api_level`](/docs/registry/attributes/android.md) | string | Uniquely identifies the framework API revision offered by a version (`os.version`) of the android operating system. More information can be found in the [Android API levels documentation](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels). | `33`; `32` | `Recommended` | ![Development](https://img.shields.io/badge/-development-blue) |
 
 
 <!-- markdownlint-restore -->
diff --git a/docs/registry/entities/app.md b/docs/registry/entities/app.md
@@ -44,7 +44,7 @@ For Android, examples of `app.installation.id` implementations include:
 - [App set ID](https://developer.android.com/identity/app-set-id).
 - [`Settings.getString(Settings.Secure.ANDROID_ID)`](https://developer.android.com/reference/android/provider/Settings.Secure#ANDROID_ID).
 
-More information about Android identifier best practices can be found [here](https://developer.android.com/training/articles/user-data-ids).
+More information about Android identifier best practices can be found in the [Android user data IDs guide](https://developer.android.com/training/articles/user-data-ids).
 
 
 <!-- markdownlint-restore -->
diff --git a/docs/registry/entities/device.md b/docs/registry/entities/device.md
@@ -35,7 +35,7 @@
 However, it might be resettable by the user for all apps on a device.
 Hardware IDs (e.g. vendor-specific serial number, IMEI or MAC address) MAY be used as values.
 
-More information about Android identifier best practices can be found [here](https://developer.android.com/training/articles/user-data-ids).
+More information about Android identifier best practices can be found in the [Android user data IDs guide](https://developer.android.com/training/articles/user-data-ids).
 
 > [!WARNING]
 >
diff --git a/docs/resource/android.md b/docs/resource/android.md
@@ -16,7 +16,7 @@
 
 | Attribute  | Type | Description  | Examples  | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
 |---|---|---|---|---|---|
-| [`android.os.api_level`](/docs/registry/attributes/android.md) | string | Uniquely identifies the framework API revision offered by a version (`os.version`) of the android operating system. More information can be found [here](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels). | `33`; `32` | `Recommended` | ![Development](https://img.shields.io/badge/-development-blue) |
+| [`android.os.api_level`](/docs/registry/attributes/android.md) | string | Uniquely identifies the framework API revision offered by a version (`os.version`) of the android operating system. More information can be found in the [Android API levels documentation](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels). | `33`; `32` | `Recommended` | ![Development](https://img.shields.io/badge/-development-blue) |
 
 <!-- markdownlint-restore -->
 <!-- prettier-ignore-end -->
diff --git a/docs/resource/device.md b/docs/resource/device.md
@@ -31,7 +31,7 @@
 However, it might be resettable by the user for all apps on a device.
 Hardware IDs (e.g. vendor-specific serial number, IMEI or MAC address) MAY be used as values.
 
-More information about Android identifier best practices can be found [here](https://developer.android.com/training/articles/user-data-ids).
+More information about Android identifier best practices can be found in the [Android user data IDs guide](https://developer.android.com/training/articles/user-data-ids).
 
 > [!WARNING]
 >
diff --git a/model/android/registry.yaml b/model/android/registry.yaml
@@ -11,7 +11,7 @@ groups:
         brief: >
           Uniquely identifies the framework API revision offered by a version
           (`os.version`) of the android operating system. More information can be found
-          [here](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels).
+          in the [Android API levels documentation](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels).
         examples: ['33', '32']
       - id: android.app.state
         stability: development
diff --git a/model/app/registry.yaml b/model/app/registry.yaml
@@ -28,7 +28,7 @@ groups:
           - [App set ID](https://developer.android.com/identity/app-set-id).
           - [`Settings.getString(Settings.Secure.ANDROID_ID)`](https://developer.android.com/reference/android/provider/Settings.Secure#ANDROID_ID).
 
-          More information about Android identifier best practices can be found [here](https://developer.android.com/training/articles/user-data-ids).
+          More information about Android identifier best practices can be found in the [Android user data IDs guide](https://developer.android.com/training/articles/user-data-ids).
         examples:
           - 2ab2916d-a51f-4ac8-80ee-45ac31a28092
       - id: app.screen.coordinate.x
diff --git a/model/device/registry.yaml b/model/device/registry.yaml
@@ -15,7 +15,7 @@ groups:
           However, it might be resettable by the user for all apps on a device.
           Hardware IDs (e.g. vendor-specific serial number, IMEI or MAC address) MAY be used as values.
 
-          More information about Android identifier best practices can be found [here](https://developer.android.com/training/articles/user-data-ids).
+          More information about Android identifier best practices can be found in the [Android user data IDs guide](https://developer.android.com/training/articles/user-data-ids).
 
           > [!WARNING]
           >

Original file line number	Diff line number	Diff line change
`@@ -18,7 +18,7 @@ Describes device attributes.`
`18`	`18`	`However, it might be resettable by the user for all apps on a device.`
`19`	`19`	`Hardware IDs (e.g. vendor-specific serial number, IMEI or MAC address) MAY be used as values.`
`20`	`20`
`21`		`-More information about Android identifier best practices can be found [here](https://developer.android.com/training/articles/user-data-ids).`
	`21`	`+More information about Android identifier best practices can be found in the [Android user data IDs guide](https://developer.android.com/training/articles/user-data-ids).`
`22`	`22`
`23`	`23`	`> [!WARNING]`
`24`	`24`	`>`
Original file line number	Diff line number	Diff line change
`@@ -35,7 +35,7 @@`
`35`	`35`	`However, it might be resettable by the user for all apps on a device.`
`36`	`36`	`Hardware IDs (e.g. vendor-specific serial number, IMEI or MAC address) MAY be used as values.`
`37`	`37`
`38`		`-More information about Android identifier best practices can be found [here](https://developer.android.com/training/articles/user-data-ids).`
	`38`	`+More information about Android identifier best practices can be found in the [Android user data IDs guide](https://developer.android.com/training/articles/user-data-ids).`
`39`	`39`
`40`	`40`	`> [!WARNING]`
`41`	`41`	`>`
Original file line number	Diff line number	Diff line change
`@@ -31,7 +31,7 @@`
`31`	`31`	`However, it might be resettable by the user for all apps on a device.`
`32`	`32`	`Hardware IDs (e.g. vendor-specific serial number, IMEI or MAC address) MAY be used as values.`
`33`	`33`
`34`		`-More information about Android identifier best practices can be found [here](https://developer.android.com/training/articles/user-data-ids).`
	`34`	`+More information about Android identifier best practices can be found in the [Android user data IDs guide](https://developer.android.com/training/articles/user-data-ids).`
`35`	`35`
`36`	`36`	`> [!WARNING]`
`37`	`37`	`>`