[chore] Consolidate thread details into yaml/registry (#2708)

Author: thompson-tomo

docs/general/attributes.md

@@ -394,25 +394,35 @@ a thread that started a span.
 
 | Attribute  | Type | Description  | Examples  | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
 |---|---|---|---|---|---|
-| [`thread.id`](/docs/registry/attributes/thread.md) | int | Current "managed" thread ID (as opposed to OS thread ID). | `42` | `Recommended` | ![Development](https://img.shields.io/badge/-development-blue) |
-| [`thread.name`](/docs/registry/attributes/thread.md) | string | Current thread name. | `main` | `Recommended` | ![Development](https://img.shields.io/badge/-development-blue) |
+| [`thread.id`](/docs/registry/attributes/thread.md) | int | Current "managed" thread ID (as opposed to OS thread ID). [1] | `42` | `Recommended` | ![Development](https://img.shields.io/badge/-development-blue) |
+| [`thread.name`](/docs/registry/attributes/thread.md) | string | Current thread name. [2] | `main` | `Recommended` | ![Development](https://img.shields.io/badge/-development-blue) |
+
+**[1] `thread.id`:** Examples of where the value can be extracted from:
+
+| Language or platform  | Source |
+| --- | --- |
+| JVM | `Thread.currentThread().threadId()` |
+| .NET | `Thread.CurrentThread.ManagedThreadId` |
+| Python | `threading.current_thread().ident` |
+| Ruby | `Thread.current.object_id` |
+| C++ | `std::this_thread::get_id()` |
+| Erlang | `erlang:self()` |
+
+**[2] `thread.name`:** Examples of where the value can be extracted from:
+
+| Language or platform  | Source |
+| --- | --- |
+| JVM | `Thread.currentThread().getName()` |
+| .NET | `Thread.CurrentThread.Name` |
+| Python | `threading.current_thread().name` |
+| Ruby | `Thread.current.name` |
+| Erlang | `erlang:process_info(self(), registered_name)` |
 
 <!-- markdownlint-restore -->
 <!-- prettier-ignore-end -->
 <!-- END AUTOGENERATED TEXT -->
 <!-- endsemconv -->
 
-Examples of where `thread.id` and `thread.name` can be extracted from:
-
-| Language or platform  | `thread.id`                            | `thread.name`                                  |
-|-----------------------|----------------------------------------|------------------------------------------------|
-| JVM                   | `Thread.currentThread().threadId()`    | `Thread.currentThread().getName()`             |
-| .NET                  | `Thread.CurrentThread.ManagedThreadId` | `Thread.CurrentThread.Name`                    |
-| Python                | `threading.current_thread().ident`     | `threading.current_thread().name`              |
-| Ruby                  | `Thread.current.object_id`             | `Thread.current.name`                          |
-| C++                   | `std::this_thread::get_id()`           |                                                |
-| Erlang                | `erlang:self()`                        | `erlang:process_info(self(), registered_name)` |
-
 ## Source code attributes
 
 **Status**: [Release Candidate][DocumentStatus]

docs/registry/attributes/thread.md

@@ -9,5 +9,26 @@ These attributes may be used for any operation to store information about a thre
 
 | Attribute | Type | Description | Examples | Stability |
 |---|---|---|---|---|
-| <a id="thread-id" href="#thread-id">`thread.id`</a> | int | Current "managed" thread ID (as opposed to OS thread ID). | `42` | ![Development](https://img.shields.io/badge/-development-blue) |
-| <a id="thread-name" href="#thread-name">`thread.name`</a> | string | Current thread name. | `main` | ![Development](https://img.shields.io/badge/-development-blue) |
+| <a id="thread-id" href="#thread-id">`thread.id`</a> | int | Current "managed" thread ID (as opposed to OS thread ID). [1] | `42` | ![Development](https://img.shields.io/badge/-development-blue) |
+| <a id="thread-name" href="#thread-name">`thread.name`</a> | string | Current thread name. [2] | `main` | ![Development](https://img.shields.io/badge/-development-blue) |
+
+**[1] `thread.id`:** Examples of where the value can be extracted from:
+
+| Language or platform  | Source |
+| --- | --- |
+| JVM | `Thread.currentThread().threadId()` |
+| .NET | `Thread.CurrentThread.ManagedThreadId` |
+| Python | `threading.current_thread().ident` |
+| Ruby | `Thread.current.object_id` |
+| C++ | `std::this_thread::get_id()` |
+| Erlang | `erlang:self()` |
+
+**[2] `thread.name`:** Examples of where the value can be extracted from:
+
+| Language or platform  | Source |
+| --- | --- |
+| JVM | `Thread.currentThread().getName()` |
+| .NET | `Thread.CurrentThread.Name` |
+| Python | `threading.current_thread().name` |
+| Ruby | `Thread.current.name` |
+| Erlang | `erlang:process_info(self(), registered_name)` |

model/thread/registry.yaml

@@ -10,10 +10,48 @@ groups:
         stability: development
         brief: >
           Current "managed" thread ID (as opposed to OS thread ID).
+        note: >
+
+          Examples of where the value can be extracted from:
+
+
+          | Language or platform  | Source |
+
+          | --- | --- |
+
+          | JVM | `Thread.currentThread().threadId()` |
+
+          | .NET | `Thread.CurrentThread.ManagedThreadId` |
+
+          | Python | `threading.current_thread().ident` |
+
+          | Ruby | `Thread.current.object_id` |
+
+          | C++ | `std::this_thread::get_id()` |
+
+          | Erlang | `erlang:self()` |
         examples: 42
       - id: thread.name
         type: string
         stability: development
         brief: >
           Current thread name.
+        note: >
+
+          Examples of where the value can be extracted from:
+
+
+          | Language or platform  | Source |
+
+          | --- | --- |
+
+          | JVM | `Thread.currentThread().getName()` |
+
+          | .NET | `Thread.CurrentThread.Name` |
+
+          | Python | `threading.current_thread().name` |
+
+          | Ruby | `Thread.current.name` |
+
+          | Erlang | `erlang:process_info(self(), registered_name)` |
         examples: main