changelog and lint

.chloggen/1716.yaml

@@ -0,0 +1,4 @@
+change_type: enhancement
+component: docs, db
+note: Add common guidance on recording errors on spans and metrics, clarify DB conventions.
+issues: [1536, 1716]

docs/database/database-spans.md

@@ -12,7 +12,6 @@ linkTitle: Client Calls
 
 - [Name](#name)
 - [Status](#status)
-  - [Recording exception events](#recording-exception-events)
 - [Common attributes](#common-attributes)
   - [Notes and well-known identifiers for `db.system`](#notes-and-well-known-identifiers-for-dbsystem)
 - [Sanitization of `db.query.text`](#sanitization-of-dbquerytext)
@@ -418,4 +417,3 @@ More specific Semantic Conventions are defined for the following database techno
 * [SQL](sql.md): Semantic Conventions for *SQL* databases.
 
 [DocumentStatus]: https://opentelemetry.io/docs/specs/otel/document-status
-[SpanStatus]: https://github.com/open-telemetry/opentelemetry-specification/tree/v1.39.0/specification/trace/api.md#set-status

docs/gen-ai/gen-ai-spans.md

@@ -11,6 +11,7 @@ linkTitle: Generative AI traces
 <!-- toc -->
 
 - [Name](#name)
+  - [Status](#status)
 - [GenAI attributes](#genai-attributes)
 - [Capturing inputs and outputs](#capturing-inputs-and-outputs)
 

docs/messaging/messaging-spans.md

@@ -22,6 +22,7 @@
   - [Span name](#span-name)
   - [Operation types](#operation-types)
   - [Span kind](#span-kind)
+  - [Span status](#span-status)
   - [Trace structure](#trace-structure)
     - [Producer spans](#producer-spans)
     - [Consumer spans](#consumer-spans)

docs/rpc/rpc-spans.md

@@ -15,6 +15,7 @@ This document defines how to describe remote procedure calls
 
 - [Common remote procedure call conventions](#common-remote-procedure-call-conventions)
   - [Span name](#span-name)
+  - [Span status](#span-status)
   - [Service name](#service-name)
   - [Client attributes](#client-attributes)
   - [Server attributes](#server-attributes)