Updating italic when in list

thompson-tomo · thompson-tomo · commit a9489f623296 · 2025-11-12T15:21:10.000+11:00
diff --git a/docs/cicd/README.md b/docs/cicd/README.md
@@ -10,8 +10,8 @@ This document defines semantic conventions for Continuous Integration and Contin
 
 Semantic conventions for CICD are defined for the following signals:
 
-- [CICD Spans](cicd-spans.md): Semantic Conventions for CICD *spans*.
-- [CICD Metrics](cicd-metrics.md): Semantic Conventions for CICD *metrics*.
-- [CICD Logs](cicd-logs.md): Semantic Conventions for CICD *logs*.
+- [CICD Spans](cicd-spans.md): Semantic Conventions for CICD _spans_.
+- [CICD Metrics](cicd-metrics.md): Semantic Conventions for CICD _metrics_.
+- [CICD Logs](cicd-logs.md): Semantic Conventions for CICD _logs_.
 
 [DocumentStatus]: https://opentelemetry.io/docs/specs/otel/document-status
diff --git a/docs/database/README.md b/docs/database/README.md
@@ -37,21 +37,21 @@ database metrics and logs.
 
 Semantic conventions for database operations are defined for the following signals:
 
-- [DB Spans](database-spans.md): Semantic Conventions for database client *spans*.
-- [DB Metrics](database-metrics.md): Semantic Conventions for database operation *metrics*.
+- [DB Spans](database-spans.md): Semantic Conventions for database client _spans_.
+- [DB Metrics](database-metrics.md): Semantic Conventions for database operation _metrics_.
 
 Technology specific semantic conventions are defined for the following databases:
 
-- [AWS DynamoDB](dynamodb.md): Semantic Conventions for *AWS DynamoDB*.
-- [Cassandra](cassandra.md): Semantic Conventions for *Cassandra*.
-- [Azure Cosmos DB](cosmosdb.md): Semantic Conventions for *Azure Cosmos DB*.
-- [CouchDB](couchdb.md): Semantic Conventions for *CouchDB*.
-- [Elasticsearch](elasticsearch.md): Semantic Conventions for *Elasticsearch*.
-- [HBase](hbase.md): Semantic Conventions for *HBase*.
-- [MongoDB](mongodb.md): Semantic Conventions for *MongoDB*.
-- [Microsoft SQL Server](sql-server.md): Semantic Conventions for *Microsoft SQL Server*.
-- [Oracle Database](oracledb.md): Semantic Conventions for *Oracle Database*.
-- [Redis](redis.md): Semantic Conventions for *Redis*.
-- [SQL](sql.md): Semantic Conventions for *SQL* databases.
+- [AWS DynamoDB](dynamodb.md): Semantic Conventions for _AWS DynamoDB_.
+- [Cassandra](cassandra.md): Semantic Conventions for _Cassandra_.
+- [Azure Cosmos DB](cosmosdb.md): Semantic Conventions for _Azure Cosmos DB_.
+- [CouchDB](couchdb.md): Semantic Conventions for _CouchDB_.
+- [Elasticsearch](elasticsearch.md): Semantic Conventions for _Elasticsearch_.
+- [HBase](hbase.md): Semantic Conventions for _HBase_.
+- [MongoDB](mongodb.md): Semantic Conventions for _MongoDB_.
+- [Microsoft SQL Server](sql-server.md): Semantic Conventions for _Microsoft SQL Server_.
+- [Oracle Database](oracledb.md): Semantic Conventions for _Oracle Database_.
+- [Redis](redis.md): Semantic Conventions for _Redis_.
+- [SQL](sql.md): Semantic Conventions for _SQL_ databases.
 
 [DocumentStatus]: https://opentelemetry.io/docs/specs/otel/document-status
diff --git a/docs/database/database-spans.md b/docs/database/database-spans.md
@@ -518,15 +518,15 @@ The instrumentation SHOULD allow users to pass a propagator to overwrite the glo
 
 More specific Semantic Conventions are defined for the following database technologies:
 
-- [AWS DynamoDB](dynamodb.md): Semantic Conventions for *AWS DynamoDB*.
-- [Cassandra](cassandra.md): Semantic Conventions for *Cassandra*.
-- [Azure Cosmos DB](cosmosdb.md): Semantic Conventions for *Azure Cosmos DB*.
-- [CouchDB](couchdb.md): Semantic Conventions for *CouchDB*.
-- [Elasticsearch](elasticsearch.md): Semantic Conventions for *Elasticsearch*.
-- [HBase](hbase.md): Semantic Conventions for *HBase*.
-- [MongoDB](mongodb.md): Semantic Conventions for *MongoDB*.
-- [Microsoft SQL Server](sql-server.md): Semantic Conventions for *Microsoft SQL Server*.
-- [Redis](redis.md): Semantic Conventions for *Redis*.
-- [SQL](sql.md): Semantic Conventions for *SQL* databases.
+- [AWS DynamoDB](dynamodb.md): Semantic Conventions for _AWS DynamoDB_.
+- [Cassandra](cassandra.md): Semantic Conventions for _Cassandra_.
+- [Azure Cosmos DB](cosmosdb.md): Semantic Conventions for _Azure Cosmos DB_.
+- [CouchDB](couchdb.md): Semantic Conventions for _CouchDB_.
+- [Elasticsearch](elasticsearch.md): Semantic Conventions for _Elasticsearch_.
+- [HBase](hbase.md): Semantic Conventions for _HBase_.
+- [MongoDB](mongodb.md): Semantic Conventions for _MongoDB_.
+- [Microsoft SQL Server](sql-server.md): Semantic Conventions for _Microsoft SQL Server_.
+- [Redis](redis.md): Semantic Conventions for _Redis_.
+- [SQL](sql.md): Semantic Conventions for _SQL_ databases.
 
 [DocumentStatus]: https://opentelemetry.io/docs/specs/otel/document-status
diff --git a/docs/database/mysql.md b/docs/database/mysql.md
@@ -13,7 +13,7 @@ linkTitle: MySQL
 
 <!-- tocstop -->
 
-The Semantic Conventions for *MySQL* extend and override the [Database Semantic Conventions](README.md).
+The Semantic Conventions for _MySQL_ extend and override the [Database Semantic Conventions](README.md).
 
 ## Spans
 
diff --git a/docs/database/oracledb.md b/docs/database/oracledb.md
@@ -15,7 +15,7 @@ linkTitle: Oracle Database
 
 <!-- tocstop -->
 
-The Semantic Conventions for *Oracle Database* extend and override the [Database Semantic Conventions](README.md).
+The Semantic Conventions for _Oracle Database_ extend and override the [Database Semantic Conventions](README.md).
 
 ## Spans
 
diff --git a/docs/database/postgresql.md b/docs/database/postgresql.md
@@ -13,7 +13,7 @@ linkTitle: PostgreSQL
 
 <!-- tocstop -->
 
-The Semantic Conventions for *PostgreSQL* extend and override the [Database Semantic Conventions](README.md).
+The Semantic Conventions for _PostgreSQL_ extend and override the [Database Semantic Conventions](README.md).
 
 ## Spans
 
diff --git a/docs/database/sql-server.md b/docs/database/sql-server.md
@@ -15,7 +15,7 @@ linkTitle: SQL Server
 
 <!-- tocstop -->
 
-The Semantic Conventions for *Microsoft SQL Server* extend and override the [Database Semantic Conventions](README.md).
+The Semantic Conventions for _Microsoft SQL Server_ extend and override the [Database Semantic Conventions](README.md).
 
 ## Spans
 
diff --git a/docs/dotnet/README.md b/docs/dotnet/README.md
@@ -8,13 +8,13 @@ This article documents semantic conventions for metrics and traces emitted by th
 
 The following span are currently supported:
 
-- [HTTP client, DNS, and TLS](dotnet-network-traces.md): Semantic Conventions for HTTP client and connection-related *spans*.
+- [HTTP client, DNS, and TLS](dotnet-network-traces.md): Semantic Conventions for HTTP client and connection-related _spans_.
 
 The following metrics are currently supported:
 
-- [ASP.NET Core](dotnet-aspnetcore-metrics.md): Semantic Conventions for ASP.NET Core routing, exceptions, and rate-limiting *metrics*.
-- [DNS](dotnet-dns-metrics.md): Semantic Conventions for client-side DNS lookups associated with *metrics*.
-- [HTTP](dotnet-http-metrics.md): Semantic Conventions for HTTP client and server *metrics*.
-- [Kestrel](dotnet-kestrel-metrics.md): Semantic Conventions for Kestrel web server *metrics*.
-- [SignalR](dotnet-signalr-metrics.md): Semantic Conventions for SignalR server *metrics*.
-- [Runtime](/docs/runtime/dotnet-metrics.md): Semantic conventions for .NET Runtime *metrics*.
+- [ASP.NET Core](dotnet-aspnetcore-metrics.md): Semantic Conventions for ASP.NET Core routing, exceptions, and rate-limiting _metrics_.
+- [DNS](dotnet-dns-metrics.md): Semantic Conventions for client-side DNS lookups associated with _metrics_.
+- [HTTP](dotnet-http-metrics.md): Semantic Conventions for HTTP client and server _metrics_.
+- [Kestrel](dotnet-kestrel-metrics.md): Semantic Conventions for Kestrel web server _metrics_.
+- [SignalR](dotnet-signalr-metrics.md): Semantic Conventions for SignalR server _metrics_.
+- [Runtime](/docs/runtime/dotnet-metrics.md): Semantic conventions for .NET Runtime _metrics_.
diff --git a/docs/exceptions/README.md b/docs/exceptions/README.md
@@ -8,7 +8,7 @@ linkTitle: Exceptions
 
 Semantic conventions for Exceptions are defined for the following signals:
 
-- [Exceptions on spans](exceptions-spans.md): Semantic Conventions for Exceptions associated with *spans*.
-- [Exceptions in logs](exceptions-logs.md): Semantic Conventions for Exceptions recorded in *logs*.
+- [Exceptions on spans](exceptions-spans.md): Semantic Conventions for Exceptions associated with _spans_.
+- [Exceptions in logs](exceptions-logs.md): Semantic Conventions for Exceptions recorded in _logs_.
 
 [DocumentStatus]: https://opentelemetry.io/docs/specs/otel/document-status
diff --git a/docs/faas/README.md b/docs/faas/README.md
@@ -10,11 +10,11 @@ This document defines semantic conventions for Function as a Service (FaaS) span
 
 Semantic conventions for FaaS are defined for the following signals:
 
-- [FaaS Spans](faas-spans.md): Semantic Conventions for FaaS *spans*.
-- [FaaS Metrics](faas-metrics.md): Semantic Conventions for FaaS *metrics*.
+- [FaaS Spans](faas-spans.md): Semantic Conventions for FaaS _spans_.
+- [FaaS Metrics](faas-metrics.md): Semantic Conventions for FaaS _metrics_.
 
 Technology specific semantic conventions are defined for the following FaaS services:
 
-- [AWS Lambda](aws-lambda.md): Semantic Conventions for *AWS Lambda*.
+- [AWS Lambda](aws-lambda.md): Semantic Conventions for _AWS Lambda_.
 
 [DocumentStatus]: https://opentelemetry.io/docs/specs/otel/document-status
diff --git a/docs/feature-flags/README.md b/docs/feature-flags/README.md
@@ -11,6 +11,6 @@ evaluations in logs.
 
 Semantic conventions for feature flags are defined for the following signals:
 
-- [Feature Flags in Events](feature-flags-events.md): Semantic Conventions for recording feature flags in *events*.
+- [Feature Flags in Events](feature-flags-events.md): Semantic Conventions for recording feature flags in _events_.
 
 [DocumentStatus]: https://opentelemetry.io/docs/specs/otel/document-status
diff --git a/docs/gen-ai/README.md b/docs/gen-ai/README.md
@@ -29,10 +29,10 @@ linkTitle: Generative AI
 
 Semantic conventions for Generative AI operations are defined for the following signals:
 
-- [Events](gen-ai-events.md): Semantic Conventions for Generative AI inputs and outputs - *events*.
-- [Metrics](gen-ai-metrics.md): Semantic Conventions for Generative AI operations - *metrics*.
-- [Model spans](gen-ai-spans.md): Semantic Conventions for Generative AI model operations - *spans*.
-- [Agent spans](gen-ai-agent-spans.md): Semantic Conventions for Generative AI agent operations - *spans*.
+- [Events](gen-ai-events.md): Semantic Conventions for Generative AI inputs and outputs - _events_.
+- [Metrics](gen-ai-metrics.md): Semantic Conventions for Generative AI operations - _metrics_.
+- [Model spans](gen-ai-spans.md): Semantic Conventions for Generative AI model operations - _spans_.
+- [Agent spans](gen-ai-agent-spans.md): Semantic Conventions for Generative AI agent operations - _spans_.
 
 Technology specific semantic conventions are defined for the following GenAI system:
 
diff --git a/docs/hardware/README.md b/docs/hardware/README.md
@@ -13,21 +13,21 @@ when creating instruments not explicitly defined in the specification.
 
 Semantic conventions for hardware are defined as following:
 
-- [Common Hardware Metrics](common.md): Semantic Conventions for *common* hardware metrics.
-- [Physical Host Metrics](host.md): Semantic Conventions for *physical host* metrics.
-- [Battery Metrics](battery.md): Semantic Conventions for *battery* metrics.
-- [CPU Metrics](cpu.md): Semantic Conventions for *CPU* metrics.
-- [Disk Controller Metrics](disk-controller.md): Semantic Conventions for *disk controller* metrics.
-- [Enclosure Metrics](enclosure.md): Semantic Conventions for *enclosure* metrics.
-- [Fan Metrics](fan.md): Semantic Conventions for *fan* metrics.
-- [GPU Metrics](gpu.md): Semantic Conventions for *GPU* metrics.
-- [Logical Disk Metrics](logical-disk.md): Semantic Conventions for *logical disk* metrics.
-- [Memory Metrics](memory.md): Semantic Conventions for *memory* metrics.
-- [Network Metrics](network.md): Semantic Conventions for *network* metrics.
-- [Physical Disk Metrics](physical-disk.md): Semantic Conventions for *physical disk* metrics.
-- [Power Supply Metrics](power-supply.md): Semantic Conventions for *power supply* metrics.
-- [Tape Drive Metrics](tape-drive.md): Semantic Conventions for *tape drive* metrics.
-- [Temperature Metrics](temperature.md): Semantic Conventions for *temperature* metrics.
-- [Voltage Metrics](voltage.md): Semantic Conventions for *voltage* metrics.
+- [Common Hardware Metrics](common.md): Semantic Conventions for _common_ hardware metrics.
+- [Physical Host Metrics](host.md): Semantic Conventions for _physical host_ metrics.
+- [Battery Metrics](battery.md): Semantic Conventions for _battery_ metrics.
+- [CPU Metrics](cpu.md): Semantic Conventions for _CPU_ metrics.
+- [Disk Controller Metrics](disk-controller.md): Semantic Conventions for _disk controller_ metrics.
+- [Enclosure Metrics](enclosure.md): Semantic Conventions for _enclosure_ metrics.
+- [Fan Metrics](fan.md): Semantic Conventions for _fan_ metrics.
+- [GPU Metrics](gpu.md): Semantic Conventions for _GPU_ metrics.
+- [Logical Disk Metrics](logical-disk.md): Semantic Conventions for _logical disk_ metrics.
+- [Memory Metrics](memory.md): Semantic Conventions for _memory_ metrics.
+- [Network Metrics](network.md): Semantic Conventions for _network_ metrics.
+- [Physical Disk Metrics](physical-disk.md): Semantic Conventions for _physical disk_ metrics.
+- [Power Supply Metrics](power-supply.md): Semantic Conventions for _power supply_ metrics.
+- [Tape Drive Metrics](tape-drive.md): Semantic Conventions for _tape drive_ metrics.
+- [Temperature Metrics](temperature.md): Semantic Conventions for _temperature_ metrics.
+- [Voltage Metrics](voltage.md): Semantic Conventions for _voltage_ metrics.
 
 [DocumentStatus]: https://opentelemetry.io/docs/specs/otel/document-status
diff --git a/docs/http/README.md b/docs/http/README.md
@@ -38,8 +38,8 @@ and various HTTP versions like 1.1, 2 and SPDY.
 
 Semantic conventions for HTTP are defined for the following signals:
 
-- [HTTP Spans](http-spans.md): Semantic Conventions for HTTP client and server *spans*.
-- [HTTP Metrics](http-metrics.md): Semantic Conventions for HTTP client and server *metrics*.
+- [HTTP Spans](http-spans.md): Semantic Conventions for HTTP client and server _spans_.
+- [HTTP Metrics](http-metrics.md): Semantic Conventions for HTTP client and server _metrics_.
 
 For help migrating from non-stable to stable conventions, see [the migration guide](../non-normative/http-migration.md).
 
diff --git a/docs/messaging/README.md b/docs/messaging/README.md
@@ -38,18 +38,18 @@ This document defines semantic conventions for messaging systems spans, metrics
 
 Semantic conventions for messaging systems are defined for the following signals:
 
-- [Messaging Spans](messaging-spans.md): Semantic Conventions for messaging *spans*.
-- [Messaging Metrics](messaging-metrics.md): Semantic Conventions for messaging *metrics*.
+- [Messaging Spans](messaging-spans.md): Semantic Conventions for messaging _spans_.
+- [Messaging Metrics](messaging-metrics.md): Semantic Conventions for messaging _metrics_.
 
 Technology specific semantic conventions are defined for the following messaging systems:
 
-- [Kafka](kafka.md): Semantic Conventions for *Apache Kafka*.
-- [RabbitMQ](rabbitmq.md): Semantic Conventions for *RabbitMQ*.
-- [RocketMQ](rocketmq.md): Semantic Conventions for *Apache RocketMQ*.
-- [SNS](sns.md): Semantic Conventions for *Amazon SNS*.
-- [SQS](sqs.md): Semantic Conventions for *Amazon SQS*.
-- [Google Cloud Pub/Sub](gcp-pubsub.md): Semantic Conventions for *Google Cloud Pub/Sub*.
-- [Azure Service Bus](azure-messaging.md#azure-service-bus): Semantic Conventions for *Azure Service Bus*.
-- [Azure Event Hubs](azure-messaging.md#azure-event-hubs): Semantic Conventions for *Azure Event Hubs*.
+- [Kafka](kafka.md): Semantic Conventions for _Apache Kafka_.
+- [RabbitMQ](rabbitmq.md): Semantic Conventions for _RabbitMQ_.
+- [RocketMQ](rocketmq.md): Semantic Conventions for _Apache RocketMQ_.
+- [SNS](sns.md): Semantic Conventions for _Amazon SNS_.
+- [SQS](sqs.md): Semantic Conventions for _Amazon SQS_.
+- [Google Cloud Pub/Sub](gcp-pubsub.md): Semantic Conventions for _Google Cloud Pub/Sub_.
+- [Azure Service Bus](azure-messaging.md#azure-service-bus): Semantic Conventions for _Azure Service Bus_.
+- [Azure Event Hubs](azure-messaging.md#azure-event-hubs): Semantic Conventions for _Azure Event Hubs_.
 
 [DocumentStatus]: https://opentelemetry.io/docs/specs/otel/document-status
diff --git a/docs/messaging/messaging-spans.md b/docs/messaging/messaging-spans.md
@@ -78,9 +78,9 @@ This envelope may offer the possibility to convey additional metadata, often in
 
 A message is sent by a message *producer* to:
 
-* Physically: some message *broker* (which can be e.g., a single server, or a cluster, or a local process reached via IPC). The broker handles the actual delivery, re-delivery, persistence, etc. In some messaging systems the broker may be identical or co-located with (some) message consumers.
-With Apache Kafka, the physical broker a message is written to depends on the number of partitions, and which broker is the *leader* of the partition the record is written to.
-* Logically: some particular message *destination*.
+- Physically: some message _broker_ (which can be e.g., a single server, or a cluster, or a local process reached via IPC). The broker handles the actual delivery, re-delivery, persistence, etc. In some messaging systems the broker may be identical or co-located with (some) message consumers.
+  With Apache Kafka, the physical broker a message is written to depends on the number of partitions, and which broker is the _leader_ of the partition the record is written to.
+- Logically: some particular message _destination_.
 
 Messages can be delivered to 0, 1, or multiple consumers depending on the dispatching semantic of the protocol.
 
@@ -212,13 +212,13 @@ a specific operation, the instrumentation SHOULD omit the `{destination}`.
 
 Examples:
 
-* `publish shop.orders`
-* `send shop.orders`
-* `subscribe shop.orders`
-* `ack shop.orders`
-* `nack print_jobs`
-* `process topic with spaces`
-* `settle AuthenticationRequest-Conversations`
+- `publish shop.orders`
+- `send shop.orders`
+- `subscribe shop.orders`
+- `ack shop.orders`
+- `nack print_jobs`
+- `process topic with spaces`
+- `settle AuthenticationRequest-Conversations`
 
 ### Operation types
 
diff --git a/docs/non-normative/code-attrs-migration.md b/docs/non-normative/code-attrs-migration.md
@@ -40,12 +40,12 @@ to
 >
 > Examples:
 >
-> * Java method: `com.example.MyHttpService.serveRequest`
-> * Java anonymous class method: `com.mycompany.Main$1.myMethod`
-> * Java lambda method: `com.mycompany.Main$$Lambda/0x0000748ae4149c00.myMethod`
-> * PHP function: `GuzzleHttp\Client::transfer`
-> * Go function: `github.com/my/repo/pkg.foo.func5`
-> * Elixir: `OpenTelemetry.Ctx.new`
-> * Erlang: `opentelemetry_ctx:new`
-> * Rust: `playground::my_module::my_cool_func`
-> * C function: `fopen`
+> - Java method: `com.example.MyHttpService.serveRequest`
+> - Java anonymous class method: `com.mycompany.Main$1.myMethod`
+> - Java lambda method: `com.mycompany.Main$$Lambda/0x0000748ae4149c00.myMethod`
+> - PHP function: `GuzzleHttp\Client::transfer`
+> - Go function: `github.com/my/repo/pkg.foo.func5`
+> - Elixir: `OpenTelemetry.Ctx.new`
+> - Erlang: `opentelemetry_ctx:new`
+> - Rust: `playground::my_module::my_cool_func`
+> - C function: `fopen`
diff --git a/docs/object-stores/README.md b/docs/object-stores/README.md
@@ -10,6 +10,6 @@ This document defines semantic conventions for object store operations.
 
 The following technology specific semantic conventions are defined for object stores:
 
-- [AWS S3](s3.md): Semantic Conventions for *AWS S3*.
+- [AWS S3](s3.md): Semantic Conventions for _AWS S3_.
 
 [DocumentStatus]: https://opentelemetry.io/docs/specs/otel/document-status
diff --git a/docs/rpc/README.md b/docs/rpc/README.md
@@ -36,14 +36,14 @@ This document defines semantic conventions for remote procedure calls (RPC)
 
 Semantic conventions for RPC are defined for the following signals:
 
-- [RPC Spans](rpc-spans.md): Semantic Conventions for RPC client and server *spans*.
-- [RPC Metrics](rpc-metrics.md): Semantic Conventions for RPC *metrics*.
+- [RPC Spans](rpc-spans.md): Semantic Conventions for RPC client and server _spans_.
+- [RPC Metrics](rpc-metrics.md): Semantic Conventions for RPC _metrics_.
 
 Technology specific semantic conventions are defined for the following RPC systems:
 
-- [Connect](connect-rpc.md): Semantic Conventions for *Connect RPC*.
-- [gRPC](grpc.md): Semantic Conventions for *gRPC*.
-- [JSON-RPC](json-rpc.md): Semantic Conventions for *JSON-RPC*.
+- [Connect](connect-rpc.md): Semantic Conventions for _Connect RPC_.
+- [gRPC](grpc.md): Semantic Conventions for _gRPC_.
+- [JSON-RPC](json-rpc.md): Semantic Conventions for _JSON-RPC_.
 
 Specifications defined by maintainers of RPC systems:
 
diff --git a/docs/rpc/rpc-metrics.md b/docs/rpc/rpc-metrics.md
diff --git a/docs/rpc/rpc-spans.md b/docs/rpc/rpc-spans.md
diff --git a/model/README.md b/model/README.md
