From 5829ac1c960ea92cfe13e6629cb36a81972ee901 Mon Sep 17 00:00:00 2001 From: James Thompson Date: Sat, 13 Jun 2026 15:18:48 +1000 Subject: [PATCH 1/6] Switch to doctoc --- .github/workflows/checks.yaml | 5 +--- Makefile | 24 ++++++------------- ...ng-attributes-to-support-complex-values.md | 2 +- oteps/4815-semantic-conventions-schema-v2.md | 2 +- oteps/entities/0256-entities-data-model.md | 2 +- oteps/entities/0264-resource-and-entities.md | 2 +- oteps/profiles/0239-profiles-data-model.md | 4 ++-- oteps/trace/0170-sampling-probability.md | 2 +- package.json | 8 ++++--- specification/baggage/api.md | 2 +- specification/common/README.md | 2 +- .../common/attribute-type-mapping.md | 2 +- .../compatibility/logging_trace_context.md | 2 +- .../prometheus_and_openmetrics.md | 2 +- specification/configuration/api.md | 2 +- specification/configuration/common.md | 2 +- specification/configuration/data-model.md | 2 +- .../sdk-environment-variables.md | 2 +- specification/configuration/sdk.md | 2 +- .../configuration/supplementary-guidelines.md | 2 +- specification/context/README.md | 2 +- specification/context/api-propagators.md | 2 +- specification/context/env-carriers.md | 2 +- specification/entities/README.md | 2 +- specification/entities/data-model.md | 2 +- specification/entities/entity-events.md | 2 +- specification/entities/entity-propagation.md | 2 +- specification/glossary.md | 2 +- specification/logs/README.md | 2 +- specification/logs/api.md | 2 +- specification/logs/data-model-appendix.md | 2 +- specification/logs/data-model.md | 2 +- specification/logs/noop.md | 2 +- specification/logs/sdk.md | 2 +- .../logs/supplementary-guidelines.md | 2 +- specification/metrics/README.md | 2 +- specification/metrics/api.md | 2 +- specification/metrics/data-model.md | 2 +- specification/metrics/noop.md | 2 +- specification/metrics/sdk.md | 2 +- .../metrics/sdk_exporters/prometheus.md | 2 +- .../metrics/supplementary-guidelines.md | 2 +- specification/overview.md | 2 +- specification/profiles/README.md | 2 +- specification/profiles/mappings.md | 2 +- specification/profiles/pprof.md | 2 +- specification/resource/README.md | 2 +- specification/resource/data-model.md | 2 +- specification/schemas/README.md | 2 +- specification/telemetry-stability.md | 2 +- specification/trace/api.md | 2 +- specification/trace/exceptions.md | 2 +- specification/trace/sdk.md | 2 +- specification/trace/tracestate-handling.md | 2 +- .../trace/tracestate-probability-sampling.md | 2 +- specification/vendors.md | 2 +- specification/versioning-and-stability.md | 2 +- 57 files changed, 68 insertions(+), 79 deletions(-) diff --git a/.github/workflows/checks.yaml b/.github/workflows/checks.yaml index 3c0eb9094b9..55ac99326c0 100644 --- a/.github/workflows/checks.yaml +++ b/.github/workflows/checks.yaml @@ -62,10 +62,7 @@ jobs: run: npm install - name: run markdown-toc - run: make markdown-toc - - - name: validate markdown-toc - run: git diff --exit-code ':*.md' || (echo 'Generated markdown Table of Contents is out of date, please run "make markdown-toc" and commit the changes in this PR.' && exit 1) + run: make markdown-toc-check compliance-matrix-check: runs-on: ubuntu-latest diff --git a/Makefile b/Makefile index 504bd6a9629..a1353579a2a 100644 --- a/Makefile +++ b/Makefile @@ -71,25 +71,15 @@ markdown-link-check: -v \ home/repo -# This target runs markdown-toc on all files that contain -# a comment . -# -# The recommended way to prepate a .md file for markdown-toc is -# to add these comments: -# -# -# .PHONY: markdown-toc markdown-toc: - @if ! npm ls markdown-toc; then npm install; fi - @for f in $(ALL_DOCS); do \ - if grep -q '' $$f; then \ - echo markdown-toc: processing $$f; \ - npx --no -- markdown-toc --no-first-h1 --no-stripHeadingTags -i $$f || exit 1; \ - else \ - echo markdown-toc: no TOC markers, skipping $$f; \ - fi; \ - done + @if ! npm ls doctoc; then npm ci; fi + npx --no -- doctoc . --update-only --mintocitems 1 --toc-pragma-style compact --notitle --entryprefix='-,*,+' || exit 1; + +.PHONY: markdown-toc-check +markdown-toc-check: + @if ! npm ls doctoc; then npm ci; fi + npx --no -- doctoc . --update-only --mintocitems 1 --toc-pragma-style compact --notitle --entryprefix='-,*,+' --dryrun || exit 1; .PHONY: markdownlint markdownlint: diff --git a/oteps/4485-extending-attributes-to-support-complex-values.md b/oteps/4485-extending-attributes-to-support-complex-values.md index 7ca2d0bd7fd..362f1009646 100644 --- a/oteps/4485-extending-attributes-to-support-complex-values.md +++ b/oteps/4485-extending-attributes-to-support-complex-values.md @@ -1,6 +1,6 @@ # Extending attributes to support complex values - + - [Glossary](#glossary) - [Why?](#why) diff --git a/oteps/4815-semantic-conventions-schema-v2.md b/oteps/4815-semantic-conventions-schema-v2.md index c2fc49cf0f0..d21fb60e3fd 100644 --- a/oteps/4815-semantic-conventions-schema-v2.md +++ b/oteps/4815-semantic-conventions-schema-v2.md @@ -1,6 +1,6 @@ # Semantic Convention Schema v2 - + - [Semantic Convention Schema v2](#semantic-convention-schema-v2) - [Motivation](#motivation) diff --git a/oteps/entities/0256-entities-data-model.md b/oteps/entities/0256-entities-data-model.md index 874736e3203..26c837439fa 100644 --- a/oteps/entities/0256-entities-data-model.md +++ b/oteps/entities/0256-entities-data-model.md @@ -4,7 +4,7 @@ This is a proposal of a data model to represent entities. The purpose of the dat is to have a common understanding of what an entity is, what data needs to be recorded, transferred, stored and interpreted by an entity observability system. - + - [Motivation](#motivation) - [Design Principles](#design-principles) diff --git a/oteps/entities/0264-resource-and-entities.md b/oteps/entities/0264-resource-and-entities.md index 4d8f7e623f3..6564a2c6dff 100644 --- a/oteps/entities/0264-resource-and-entities.md +++ b/oteps/entities/0264-resource-and-entities.md @@ -6,7 +6,7 @@ current resource specification. It is an expansion on the [previous entity proposal](0256-entities-data-model.md). - + - [Motivation](#motivation) - [Design](#design) diff --git a/oteps/profiles/0239-profiles-data-model.md b/oteps/profiles/0239-profiles-data-model.md index acce8ddc7e3..2acf738cecc 100644 --- a/oteps/profiles/0239-profiles-data-model.md +++ b/oteps/profiles/0239-profiles-data-model.md @@ -2,7 +2,7 @@ Introduces Data Model for Profiles signal to OpenTelemetry. - + * [Motivation](#motivation) * [Design Notes](#design-notes) * [Design Goals](#design-goals) @@ -56,7 +56,7 @@ Introduces Data Model for Profiles signal to OpenTelemetry. * [Repetition of Attribute Keys](#repetition-of-attribute-keys) * [Locations Optimization](#locations-optimization) * [Future Possibilities](#future-possibilities) - + ## Motivation diff --git a/oteps/trace/0170-sampling-probability.md b/oteps/trace/0170-sampling-probability.md index 8b8c3369c05..1bc77038b0a 100644 --- a/oteps/trace/0170-sampling-probability.md +++ b/oteps/trace/0170-sampling-probability.md @@ -1,6 +1,6 @@ # Probability sampling of telemetry events - + - [Motivation](#motivation) - [Examples](#examples) diff --git a/package.json b/package.json index 56172f63f78..c203ae7da62 100644 --- a/package.json +++ b/package.json @@ -1,15 +1,17 @@ { "devDependencies": { "@cspell/dict-people-names": "1.1.16", - "cspell": "10.0.1", + "cspell": "9.7.0", + "doctoc": "2.5.0", "markdown-link-check": "3.14.2", - "markdown-toc": "1.2.0", "markdownlint-cli": "0.48.0", - "textlint": "15.7.1", + "textlint": "15.5.2", "textlint-filter-rule-allowlist": "4.0.0", "textlint-filter-rule-comments": "1.3.0", "textlint-rule-common-misspellings": "1.0.1", "textlint-rule-period-in-header": "0.1.2", "textlint-rule-terminology": "5.2.16" + }, + "dependencies": { } } diff --git a/specification/baggage/api.md b/specification/baggage/api.md index 56851acfc0e..13944757502 100644 --- a/specification/baggage/api.md +++ b/specification/baggage/api.md @@ -10,7 +10,7 @@ weight: 1
Table of Contents - + - [Overview](#overview) - [Operations](#operations) diff --git a/specification/common/README.md b/specification/common/README.md index e712fbd63b8..90344445972 100644 --- a/specification/common/README.md +++ b/specification/common/README.md @@ -13,7 +13,7 @@ path_base_for_github_subdir:
Table of Contents - + - [AnyValue](#anyvalue) * [map](#mapstring-anyvalue) diff --git a/specification/common/attribute-type-mapping.md b/specification/common/attribute-type-mapping.md index e936eb1695c..dc3cc4d5097 100644 --- a/specification/common/attribute-type-mapping.md +++ b/specification/common/attribute-type-mapping.md @@ -9,7 +9,7 @@ linkTitle: Mapping to AnyValue
Table of Contents - + - [Converting to AnyValue](#converting-to-anyvalue) * [Primitive Values](#primitive-values) diff --git a/specification/compatibility/logging_trace_context.md b/specification/compatibility/logging_trace_context.md index 17721136c98..ef46f8684c3 100644 --- a/specification/compatibility/logging_trace_context.md +++ b/specification/compatibility/logging_trace_context.md @@ -5,7 +5,7 @@
Table of Contents - + - [Overview](#overview) * [Syslog RFC5424](#syslog-rfc5424) diff --git a/specification/compatibility/prometheus_and_openmetrics.md b/specification/compatibility/prometheus_and_openmetrics.md index da763aaff2b..37189655795 100644 --- a/specification/compatibility/prometheus_and_openmetrics.md +++ b/specification/compatibility/prometheus_and_openmetrics.md @@ -12,7 +12,7 @@ aliases:
Table of Contents - + - [Differences between Prometheus formats](#differences-between-prometheus-formats) - [Prometheus Metric points to OTLP](#prometheus-metric-points-to-otlp) diff --git a/specification/configuration/api.md b/specification/configuration/api.md index 34d48f9983e..941137bea1a 100644 --- a/specification/configuration/api.md +++ b/specification/configuration/api.md @@ -7,7 +7,7 @@ weight: 1 **Status**: [Mixed](../document-status.md) - + - [Overview](#overview) * [ConfigProvider](#configprovider) diff --git a/specification/configuration/common.md b/specification/configuration/common.md index 4e94b1c8030..74609db36e6 100644 --- a/specification/configuration/common.md +++ b/specification/configuration/common.md @@ -13,7 +13,7 @@ aliases:
Table of Contents - + - [Type-specific guidance](#type-specific-guidance) * [Numeric](#numeric) diff --git a/specification/configuration/data-model.md b/specification/configuration/data-model.md index 3ce8aa1aac6..ce9792d330d 100644 --- a/specification/configuration/data-model.md +++ b/specification/configuration/data-model.md @@ -7,7 +7,7 @@ weight: 2 **Status**: [Stable](../document-status.md) - + - [Overview](#overview) * [Versioning policy and stability guarantees](#versioning-policy-and-stability-guarantees) diff --git a/specification/configuration/sdk-environment-variables.md b/specification/configuration/sdk-environment-variables.md index c3da58e16e1..501bfdb3eba 100644 --- a/specification/configuration/sdk-environment-variables.md +++ b/specification/configuration/sdk-environment-variables.md @@ -13,7 +13,7 @@ aliases:
Table of Contents - + - [Implementation guidelines](#implementation-guidelines) - [Parsing empty value](#parsing-empty-value) diff --git a/specification/configuration/sdk.md b/specification/configuration/sdk.md index c92d5ad3125..a87b42d0dcc 100644 --- a/specification/configuration/sdk.md +++ b/specification/configuration/sdk.md @@ -7,7 +7,7 @@ weight: 3 **Status**: [Stable](../document-status.md) except where otherwise specified - + - [Overview](#overview) * [In-Memory configuration model](#in-memory-configuration-model) diff --git a/specification/configuration/supplementary-guidelines.md b/specification/configuration/supplementary-guidelines.md index 6eee879d9f6..1f3bbc823bd 100644 --- a/specification/configuration/supplementary-guidelines.md +++ b/specification/configuration/supplementary-guidelines.md @@ -7,7 +7,7 @@ requirements to the existing specifications.
Table of Contents - + - [Configuration interface prioritization and `create`](#configuration-interface-prioritization-and-create) - [Programmatic customization and `create`](#programmatic-customization-and-create) diff --git a/specification/context/README.md b/specification/context/README.md index 307b06b13df..24ed3418ca0 100644 --- a/specification/context/README.md +++ b/specification/context/README.md @@ -12,7 +12,7 @@ path_base_for_github_subdir:
Table of Contents - + - [Overview](#overview) - [Create a key](#create-a-key) diff --git a/specification/context/api-propagators.md b/specification/context/api-propagators.md index 21c3773fc66..332d784ecd7 100644 --- a/specification/context/api-propagators.md +++ b/specification/context/api-propagators.md @@ -5,7 +5,7 @@
Table of Contents - + - [Overview](#overview) - [Propagator Types](#propagator-types) diff --git a/specification/context/env-carriers.md b/specification/context/env-carriers.md index e86278bc210..10fda2d4e4d 100644 --- a/specification/context/env-carriers.md +++ b/specification/context/env-carriers.md @@ -5,7 +5,7 @@
Table of Contents - + - [Overview](#overview) - [Propagator Mechanisms](#propagator-mechanisms) diff --git a/specification/entities/README.md b/specification/entities/README.md index aa76308f505..485a7fe6196 100644 --- a/specification/entities/README.md +++ b/specification/entities/README.md @@ -9,7 +9,7 @@ path_base_for_github_subdir:
Table of Contents - + - [Overview](#overview) - [Specifications](#specifications) diff --git a/specification/entities/data-model.md b/specification/entities/data-model.md index 9bbb4e95be0..7e794cb0172 100644 --- a/specification/entities/data-model.md +++ b/specification/entities/data-model.md @@ -10,7 +10,7 @@ weight: 2
Table of Contents - + - [Minimally Sufficient Identity](#minimally-sufficient-identity) - [Repeatable Identity](#repeatable-identity) diff --git a/specification/entities/entity-events.md b/specification/entities/entity-events.md index ab8b055d94b..812f95d0bfa 100644 --- a/specification/entities/entity-events.md +++ b/specification/entities/entity-events.md @@ -10,7 +10,7 @@ weight: 3
Table of Contents - + - [Overview](#overview) - [When to Use Entity Events](#when-to-use-entity-events) diff --git a/specification/entities/entity-propagation.md b/specification/entities/entity-propagation.md index a46dda2a44f..b871d158efc 100644 --- a/specification/entities/entity-propagation.md +++ b/specification/entities/entity-propagation.md @@ -9,7 +9,7 @@ linkTitle: Entity Propagation
Table of Contents - + - [Overview](#overview) - [Specifying entity information via an environment variable](#specifying-entity-information-via-an-environment-variable) diff --git a/specification/glossary.md b/specification/glossary.md index 64405a7a486..05f71534721 100644 --- a/specification/glossary.md +++ b/specification/glossary.md @@ -7,7 +7,7 @@ Some other fundamental terms are documented in the [overview document](overview.
Table of Contents - + - [User Roles](#user-roles) * [Application Owner](#application-owner) diff --git a/specification/logs/README.md b/specification/logs/README.md index 59cc21833bc..8780e44c585 100644 --- a/specification/logs/README.md +++ b/specification/logs/README.md @@ -14,7 +14,7 @@ path_base_for_github_subdir:
Table of Contents - + - [Introduction](#introduction) - [Limitations of non-OpenTelemetry Solutions](#limitations-of-non-opentelemetry-solutions) diff --git a/specification/logs/api.md b/specification/logs/api.md index f4e2e9237dd..483e0aeaa7e 100644 --- a/specification/logs/api.md +++ b/specification/logs/api.md @@ -13,7 +13,7 @@ aliases: [bridge-api] - + - [LoggerProvider](#loggerprovider) * [LoggerProvider operations](#loggerprovider-operations) diff --git a/specification/logs/data-model-appendix.md b/specification/logs/data-model-appendix.md index ada07be406c..9cdda207164 100644 --- a/specification/logs/data-model-appendix.md +++ b/specification/logs/data-model-appendix.md @@ -5,7 +5,7 @@ Note: this document is NOT a spec, it is provided to support the Logs for demonstrative purposes and are not exhaustive or canonical; please refer to the respective exporter documentation if exact details are required. - + - [Appendix A. Example Mappings](#appendix-a-example-mappings) * [RFC5424 Syslog](#rfc5424-syslog) diff --git a/specification/logs/data-model.md b/specification/logs/data-model.md index 3bc6d581c4f..11844d4d3a9 100644 --- a/specification/logs/data-model.md +++ b/specification/logs/data-model.md @@ -10,7 +10,7 @@ weight: 2
Table of Contents - + - [Design Notes](#design-notes) * [Requirements](#requirements) diff --git a/specification/logs/noop.md b/specification/logs/noop.md index 2253cbb830c..b3cce39a364 100644 --- a/specification/logs/noop.md +++ b/specification/logs/noop.md @@ -9,7 +9,7 @@ linkTitle: No-Op
Table of Contents - + - [LoggerProvider](#loggerprovider) * [Logger Creation](#logger-creation) diff --git a/specification/logs/sdk.md b/specification/logs/sdk.md index fb8bb108173..2ab2362a970 100644 --- a/specification/logs/sdk.md +++ b/specification/logs/sdk.md @@ -10,7 +10,7 @@ weight: 3
Table of Contents - + - [LoggerProvider](#loggerprovider) * [LoggerProvider Creation](#loggerprovider-creation) diff --git a/specification/logs/supplementary-guidelines.md b/specification/logs/supplementary-guidelines.md index ed46c91a517..a01c97b76cc 100644 --- a/specification/logs/supplementary-guidelines.md +++ b/specification/logs/supplementary-guidelines.md @@ -9,7 +9,7 @@ extra requirements to the existing specifications. - + - [Usage](#usage) * [How to Create a Log4J Log Appender](#how-to-create-a-log4j-log-appender) diff --git a/specification/metrics/README.md b/specification/metrics/README.md index be3cf295077..e02497b2ff0 100644 --- a/specification/metrics/README.md +++ b/specification/metrics/README.md @@ -10,7 +10,7 @@ path_base_for_github_subdir:
Table of Contents - + - [Overview](#overview) * [Design Goals](#design-goals) diff --git a/specification/metrics/api.md b/specification/metrics/api.md index ba733a04c56..4672005788a 100644 --- a/specification/metrics/api.md +++ b/specification/metrics/api.md @@ -10,7 +10,7 @@ weight: 1
Table of Contents - + - [Overview](#overview) - [MeterProvider](#meterprovider) diff --git a/specification/metrics/data-model.md b/specification/metrics/data-model.md index e36e1a3497e..75d1260871e 100644 --- a/specification/metrics/data-model.md +++ b/specification/metrics/data-model.md @@ -11,7 +11,7 @@ weight: 2
Table of Contents - + - [Overview](#overview) - [Events => Data Stream => Timeseries](#events--data-stream--timeseries) diff --git a/specification/metrics/noop.md b/specification/metrics/noop.md index 3a7e81a4caf..a602d0bcf07 100644 --- a/specification/metrics/noop.md +++ b/specification/metrics/noop.md @@ -9,7 +9,7 @@ linkTitle: No-Op
Table of Contents - + - [MeterProvider](#meterprovider) * [Meter Creation](#meter-creation) diff --git a/specification/metrics/sdk.md b/specification/metrics/sdk.md index 0f7a844446d..83bb4bdf238 100644 --- a/specification/metrics/sdk.md +++ b/specification/metrics/sdk.md @@ -10,7 +10,7 @@ weight: 3
Table of Contents - + - [MeterProvider](#meterprovider) * [MeterProvider Creation](#meterprovider-creation) diff --git a/specification/metrics/sdk_exporters/prometheus.md b/specification/metrics/sdk_exporters/prometheus.md index 430324150d1..a5a028aa81e 100644 --- a/specification/metrics/sdk_exporters/prometheus.md +++ b/specification/metrics/sdk_exporters/prometheus.md @@ -9,7 +9,7 @@ linkTitle: Prometheus
Table of Contents - + - [Prometheus Exporter Model](#prometheus-exporter-model) * [Pull Metric Exporter](#pull-metric-exporter) diff --git a/specification/metrics/supplementary-guidelines.md b/specification/metrics/supplementary-guidelines.md index 48fa01eaaeb..20463be6e04 100644 --- a/specification/metrics/supplementary-guidelines.md +++ b/specification/metrics/supplementary-guidelines.md @@ -7,7 +7,7 @@ requirements to the existing specifications.
Table of Contents - + - [Guidelines for instrumentation library authors](#guidelines-for-instrumentation-library-authors) * [Instrument selection](#instrument-selection) diff --git a/specification/overview.md b/specification/overview.md index 90dfc00bef8..336bd100009 100644 --- a/specification/overview.md +++ b/specification/overview.md @@ -7,7 +7,7 @@ weight: 1
Table of Contents - + - [OpenTelemetry Client Architecture](#opentelemetry-client-architecture) * [API](#api) diff --git a/specification/profiles/README.md b/specification/profiles/README.md index 2ecfd7d3d3f..8eebcff2bd7 100644 --- a/specification/profiles/README.md +++ b/specification/profiles/README.md @@ -11,7 +11,7 @@ path_base_for_github_subdir:
Table of Contents - + - [Overview](#overview) - [Design goals](#design-goals) diff --git a/specification/profiles/mappings.md b/specification/profiles/mappings.md index 893300e1bcd..26a1ad4d402 100644 --- a/specification/profiles/mappings.md +++ b/specification/profiles/mappings.md @@ -4,7 +4,7 @@ This document defines the required attributes of [`Mapping`](../../oteps/profiles/0239-profiles-data-model.md#message-mapping) messages. - + - [Attributes](#attributes) * [Algorithm for `process.executable.build_id.htlhash`](#algorithm-for-processexecutablebuild_idhtlhash) diff --git a/specification/profiles/pprof.md b/specification/profiles/pprof.md index 89f65379957..c9af46551ef 100644 --- a/specification/profiles/pprof.md +++ b/specification/profiles/pprof.md @@ -2,7 +2,7 @@ **Status**: [Alpha](../document-status.md) - + - [Compatibility](#compatibility) diff --git a/specification/resource/README.md b/specification/resource/README.md index 94009584626..5e506a9aed2 100644 --- a/specification/resource/README.md +++ b/specification/resource/README.md @@ -9,7 +9,7 @@ path_base_for_github_subdir:
Table of Contents - + - [Overview](#overview) * [Identity](#identity) diff --git a/specification/resource/data-model.md b/specification/resource/data-model.md index f77bafcef5c..03bac35b47d 100644 --- a/specification/resource/data-model.md +++ b/specification/resource/data-model.md @@ -10,7 +10,7 @@ weight: 2
Table of Contents - + - [Identity](#identity) - [Merging Resources](#merging-resources) diff --git a/specification/schemas/README.md b/specification/schemas/README.md index 62bb9e8b34d..736ddcdef64 100644 --- a/specification/schemas/README.md +++ b/specification/schemas/README.md @@ -13,7 +13,7 @@ path_base_for_github_subdir:
Table of Contents - + - [Motivation](#motivation) - [How Schemas Work](#how-schemas-work) diff --git a/specification/telemetry-stability.md b/specification/telemetry-stability.md index 1bf3739b05d..873082e961f 100644 --- a/specification/telemetry-stability.md +++ b/specification/telemetry-stability.md @@ -5,7 +5,7 @@
Table of Contents - + - [Unstable Instrumentations](#unstable-instrumentations) - [Stable Instrumentations](#stable-instrumentations) diff --git a/specification/trace/api.md b/specification/trace/api.md index dba798a1849..307abb89097 100644 --- a/specification/trace/api.md +++ b/specification/trace/api.md @@ -10,7 +10,7 @@ weight: 1
Table of Contents - + - [Data types](#data-types) * [Time](#time) diff --git a/specification/trace/exceptions.md b/specification/trace/exceptions.md index d0377d3958b..5662da35ec8 100644 --- a/specification/trace/exceptions.md +++ b/specification/trace/exceptions.md @@ -4,7 +4,7 @@ This document defines how to record exceptions and their attributes. - + - [Recording an Exception](#recording-an-exception) - [Attributes](#attributes) diff --git a/specification/trace/sdk.md b/specification/trace/sdk.md index 079e9e43404..a1a2566a1cc 100644 --- a/specification/trace/sdk.md +++ b/specification/trace/sdk.md @@ -10,7 +10,7 @@ weight: 3
Table of Contents - + - [Tracer Provider](#tracer-provider) * [Tracer Creation](#tracer-creation) diff --git a/specification/trace/tracestate-handling.md b/specification/trace/tracestate-handling.md index 2b4a3d85e65..2639f93b5db 100644 --- a/specification/trace/tracestate-handling.md +++ b/specification/trace/tracestate-handling.md @@ -9,7 +9,7 @@ linkTitle: TraceState
Table of Contents - + - [Key](#key) - [Value](#value) diff --git a/specification/trace/tracestate-probability-sampling.md b/specification/trace/tracestate-probability-sampling.md index 0bea3268801..718012cbf4b 100644 --- a/specification/trace/tracestate-probability-sampling.md +++ b/specification/trace/tracestate-probability-sampling.md @@ -10,7 +10,7 @@ aliases: [tracestate-probability-sampling-experimental]
Table of Contents - + - [Overview](#overview) - [Definitions](#definitions) diff --git a/specification/vendors.md b/specification/vendors.md index 05b27904e84..dd021d49baf 100644 --- a/specification/vendors.md +++ b/specification/vendors.md @@ -3,7 +3,7 @@
Table of Contents - + - [Abstract](#abstract) - [Supports OpenTelemetry](#supports-opentelemetry) diff --git a/specification/versioning-and-stability.md b/specification/versioning-and-stability.md index 2e5e3ea1d08..1f4b4c496a7 100644 --- a/specification/versioning-and-stability.md +++ b/specification/versioning-and-stability.md @@ -5,7 +5,7 @@
Table of Contents - + - [Design goals](#design-goals) - [Signal lifecycle](#signal-lifecycle) From 980a89e8124fa30e000261afb75c607ac883b57f Mon Sep 17 00:00:00 2001 From: James Thompson Date: Sat, 13 Jun 2026 22:54:26 +1000 Subject: [PATCH 2/6] Add 'notitle' to cspell configuration --- .cspell.yaml | 1 + 1 file changed, 1 insertion(+) diff --git a/.cspell.yaml b/.cspell.yaml index b8334d15be4..e99a448813f 100644 --- a/.cspell.yaml +++ b/.cspell.yaml @@ -99,6 +99,7 @@ words: - cumulatives - deser - inclusivity + - notitle - oteps - representivity - relatedly From c6f0432f5db07bc72438a86004cb5883b38a4dcf Mon Sep 17 00:00:00 2001 From: James Thompson Date: Mon, 15 Jun 2026 22:09:08 +1000 Subject: [PATCH 3/6] Update package.json --- package.json | 2 -- 1 file changed, 2 deletions(-) diff --git a/package.json b/package.json index c203ae7da62..511b791f08a 100644 --- a/package.json +++ b/package.json @@ -11,7 +11,5 @@ "textlint-rule-common-misspellings": "1.0.1", "textlint-rule-period-in-header": "0.1.2", "textlint-rule-terminology": "5.2.16" - }, - "dependencies": { } } From a10d63af2d12d7f666a31e3b6e4aafa604eac539 Mon Sep 17 00:00:00 2001 From: James Thompson Date: Mon, 15 Jun 2026 22:11:17 +1000 Subject: [PATCH 4/6] Descope --- package.json | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/package.json b/package.json index 511b791f08a..1a72b234dba 100644 --- a/package.json +++ b/package.json @@ -1,11 +1,11 @@ { "devDependencies": { "@cspell/dict-people-names": "1.1.16", - "cspell": "9.7.0", + "cspell": "10.0.1", "doctoc": "2.5.0", "markdown-link-check": "3.14.2", "markdownlint-cli": "0.48.0", - "textlint": "15.5.2", + "textlint": "15.7.1", "textlint-filter-rule-allowlist": "4.0.0", "textlint-filter-rule-comments": "1.3.0", "textlint-rule-common-misspellings": "1.0.1", From 81ef39987f9568c2a952ea685fce65af0876820f Mon Sep 17 00:00:00 2001 From: James Thompson Date: Tue, 16 Jun 2026 02:29:16 +1000 Subject: [PATCH 5/6] update end toc markers --- oteps/4485-extending-attributes-to-support-complex-values.md | 2 +- oteps/4815-semantic-conventions-schema-v2.md | 2 +- oteps/entities/0256-entities-data-model.md | 2 +- oteps/entities/0264-resource-and-entities.md | 2 +- oteps/trace/0170-sampling-probability.md | 2 +- specification/baggage/api.md | 2 +- specification/common/README.md | 2 +- specification/common/attribute-type-mapping.md | 2 +- specification/compatibility/logging_trace_context.md | 2 +- specification/compatibility/prometheus_and_openmetrics.md | 2 +- specification/configuration/api.md | 2 +- specification/configuration/common.md | 2 +- specification/configuration/data-model.md | 2 +- specification/configuration/sdk-environment-variables.md | 2 +- specification/configuration/sdk.md | 2 +- specification/configuration/supplementary-guidelines.md | 2 +- specification/context/README.md | 2 +- specification/context/api-propagators.md | 2 +- specification/context/env-carriers.md | 2 +- specification/entities/README.md | 2 +- specification/entities/data-model.md | 2 +- specification/entities/entity-events.md | 2 +- specification/entities/entity-propagation.md | 2 +- specification/glossary.md | 2 +- specification/logs/README.md | 2 +- specification/logs/api.md | 2 +- specification/logs/data-model-appendix.md | 2 +- specification/logs/data-model.md | 2 +- specification/logs/noop.md | 2 +- specification/logs/sdk.md | 2 +- specification/logs/supplementary-guidelines.md | 2 +- specification/metrics/README.md | 2 +- specification/metrics/api.md | 2 +- specification/metrics/data-model.md | 2 +- specification/metrics/noop.md | 2 +- specification/metrics/sdk.md | 2 +- specification/metrics/sdk_exporters/prometheus.md | 2 +- specification/metrics/supplementary-guidelines.md | 2 +- specification/overview.md | 2 +- specification/profiles/README.md | 2 +- specification/profiles/mappings.md | 2 +- specification/profiles/pprof.md | 2 +- specification/resource/README.md | 2 +- specification/resource/data-model.md | 2 +- specification/schemas/README.md | 2 +- specification/telemetry-stability.md | 2 +- specification/trace/api.md | 2 +- specification/trace/exceptions.md | 2 +- specification/trace/sdk.md | 2 +- specification/trace/tracestate-handling.md | 2 +- specification/trace/tracestate-probability-sampling.md | 2 +- specification/vendors.md | 2 +- specification/versioning-and-stability.md | 2 +- 53 files changed, 53 insertions(+), 53 deletions(-) diff --git a/oteps/4485-extending-attributes-to-support-complex-values.md b/oteps/4485-extending-attributes-to-support-complex-values.md index 362f1009646..bd07e849793 100644 --- a/oteps/4485-extending-attributes-to-support-complex-values.md +++ b/oteps/4485-extending-attributes-to-support-complex-values.md @@ -25,7 +25,7 @@ - [Backend research](#backend-research) - [Appendix](#appendix) - + ## Glossary diff --git a/oteps/4815-semantic-conventions-schema-v2.md b/oteps/4815-semantic-conventions-schema-v2.md index d21fb60e3fd..f258dfcf866 100644 --- a/oteps/4815-semantic-conventions-schema-v2.md +++ b/oteps/4815-semantic-conventions-schema-v2.md @@ -28,7 +28,7 @@ - [Prototypes](#prototypes) - [Future possibilities](#future-possibilities) - + In this OTEP, we propose a new telemetry schema format that supports multiple convention registries and provides full access to metadata. diff --git a/oteps/entities/0256-entities-data-model.md b/oteps/entities/0256-entities-data-model.md index 26c837439fa..f9cac8de32a 100644 --- a/oteps/entities/0256-entities-data-model.md +++ b/oteps/entities/0256-entities-data-model.md @@ -37,7 +37,7 @@ transferred, stored and interpreted by an entity observability system. - [Future Work](#future-work) - [References](#references) - + ## Motivation diff --git a/oteps/entities/0264-resource-and-entities.md b/oteps/entities/0264-resource-and-entities.md index 6564a2c6dff..21d66a191b2 100644 --- a/oteps/entities/0264-resource-and-entities.md +++ b/oteps/entities/0264-resource-and-entities.md @@ -55,7 +55,7 @@ It is an expansion on the [previous entity proposal](0256-entities-data-model.md * [Implications](#implications) * [What could this mean for choosing entities that belong on resource?](#what-could-this-mean-for-choosing-entities-that-belong-on-resource) - + ## Motivation diff --git a/oteps/trace/0170-sampling-probability.md b/oteps/trace/0170-sampling-probability.md index 1bc77038b0a..5dccec06fec 100644 --- a/oteps/trace/0170-sampling-probability.md +++ b/oteps/trace/0170-sampling-probability.md @@ -35,7 +35,7 @@ - [Recommended reading](#recommended-reading) - [Acknowledgements](#acknowledgements) - + Objective: Specify a foundation for sampling techniques in OpenTelemetry. diff --git a/specification/baggage/api.md b/specification/baggage/api.md index 13944757502..62ed2c65f96 100644 --- a/specification/baggage/api.md +++ b/specification/baggage/api.md @@ -23,7 +23,7 @@ weight: 1 - [Propagation](#propagation) - [Conflict Resolution](#conflict-resolution) - +
diff --git a/specification/common/README.md b/specification/common/README.md index 90344445972..1b5d2fb1f30 100644 --- a/specification/common/README.md +++ b/specification/common/README.md @@ -34,7 +34,7 @@ path_base_for_github_subdir: * [Configurable Parameters](#configurable-parameters) * [Exempt Entities](#exempt-entities) - +
diff --git a/specification/common/attribute-type-mapping.md b/specification/common/attribute-type-mapping.md index dc3cc4d5097..4d713cde42d 100644 --- a/specification/common/attribute-type-mapping.md +++ b/specification/common/attribute-type-mapping.md @@ -26,7 +26,7 @@ linkTitle: Mapping to AnyValue * [Other Values](#other-values) * [Empty Values](#empty-values) - +
diff --git a/specification/compatibility/logging_trace_context.md b/specification/compatibility/logging_trace_context.md index ef46f8684c3..2b475b702df 100644 --- a/specification/compatibility/logging_trace_context.md +++ b/specification/compatibility/logging_trace_context.md @@ -13,7 +13,7 @@ * [JSON Formats](#json-formats) * [Other Structured Formats](#other-structured-formats) - +
diff --git a/specification/compatibility/prometheus_and_openmetrics.md b/specification/compatibility/prometheus_and_openmetrics.md index 37189655795..b5458cd5eeb 100644 --- a/specification/compatibility/prometheus_and_openmetrics.md +++ b/specification/compatibility/prometheus_and_openmetrics.md @@ -44,7 +44,7 @@ aliases: * [Exemplar Conversion](#exemplar-conversion) * [Resource Attributes](#resource-attributes-1) - +
diff --git a/specification/configuration/api.md b/specification/configuration/api.md index 941137bea1a..a4066446d81 100644 --- a/specification/configuration/api.md +++ b/specification/configuration/api.md @@ -15,7 +15,7 @@ weight: 1 - [Get instrumentation config](#get-instrumentation-config) * [ConfigProperties](#configproperties) - + ## Overview diff --git a/specification/configuration/common.md b/specification/configuration/common.md index 74609db36e6..b6c24edd7fa 100644 --- a/specification/configuration/common.md +++ b/specification/configuration/common.md @@ -23,7 +23,7 @@ aliases: * [String](#string) + [Enum](#enum) - +
diff --git a/specification/configuration/data-model.md b/specification/configuration/data-model.md index ce9792d330d..e8f5e185317 100644 --- a/specification/configuration/data-model.md +++ b/specification/configuration/data-model.md @@ -15,7 +15,7 @@ weight: 2 + [YAML file format](#yaml-file-format) + [Environment variable substitution](#environment-variable-substitution) - + ## Overview diff --git a/specification/configuration/sdk-environment-variables.md b/specification/configuration/sdk-environment-variables.md index 501bfdb3eba..a6ad490221b 100644 --- a/specification/configuration/sdk-environment-variables.md +++ b/specification/configuration/sdk-environment-variables.md @@ -39,7 +39,7 @@ aliases: - [Declarative configuration](#declarative-configuration) - [Language Specific Environment Variables](#language-specific-environment-variables) - +
diff --git a/specification/configuration/sdk.md b/specification/configuration/sdk.md index a87b42d0dcc..774d5c63479 100644 --- a/specification/configuration/sdk.md +++ b/specification/configuration/sdk.md @@ -26,7 +26,7 @@ weight: 3 + [Via OTEL_CONFIG_FILE](#via-otel_config_file) * [References](#references) - + ## Overview diff --git a/specification/configuration/supplementary-guidelines.md b/specification/configuration/supplementary-guidelines.md index 1f3bbc823bd..ddf57e0e889 100644 --- a/specification/configuration/supplementary-guidelines.md +++ b/specification/configuration/supplementary-guidelines.md @@ -13,7 +13,7 @@ requirements to the existing specifications. - [Programmatic customization and `create`](#programmatic-customization-and-create) - [Strict YAML parsing](#strict-yaml-parsing) - +
diff --git a/specification/context/README.md b/specification/context/README.md index 24ed3418ca0..5c3a5269f68 100644 --- a/specification/context/README.md +++ b/specification/context/README.md @@ -23,7 +23,7 @@ path_base_for_github_subdir: * [Attach Context](#attach-context) * [Detach Context](#detach-context) - +
diff --git a/specification/context/api-propagators.md b/specification/context/api-propagators.md index 332d784ecd7..374ea68f792 100644 --- a/specification/context/api-propagators.md +++ b/specification/context/api-propagators.md @@ -39,7 +39,7 @@ + [Fields](#fields-1) + [Configuration](#configuration) - +
diff --git a/specification/context/env-carriers.md b/specification/context/env-carriers.md index 10fda2d4e4d..7b0a334a72b 100644 --- a/specification/context/env-carriers.md +++ b/specification/context/env-carriers.md @@ -16,7 +16,7 @@ + [Security](#security) - [Supplementary Guidelines](#supplementary-guidelines) - +
diff --git a/specification/entities/README.md b/specification/entities/README.md index 485a7fe6196..fce3cc02787 100644 --- a/specification/entities/README.md +++ b/specification/entities/README.md @@ -14,7 +14,7 @@ path_base_for_github_subdir: - [Overview](#overview) - [Specifications](#specifications) - +
diff --git a/specification/entities/data-model.md b/specification/entities/data-model.md index 7e794cb0172..944fd198e87 100644 --- a/specification/entities/data-model.md +++ b/specification/entities/data-model.md @@ -21,7 +21,7 @@ weight: 2 - [Merging of Entities](#merging-of-entities) - [Examples of Entities](#examples-of-entities) - +
diff --git a/specification/entities/entity-events.md b/specification/entities/entity-events.md index 812f95d0bfa..95d811726a2 100644 --- a/specification/entities/entity-events.md +++ b/specification/entities/entity-events.md @@ -26,7 +26,7 @@ weight: 3 * [Kubernetes Pod Entity State](#kubernetes-pod-entity-state) * [Entity Delete](#entity-delete) - +
diff --git a/specification/entities/entity-propagation.md b/specification/entities/entity-propagation.md index b871d158efc..69806b2b4a0 100644 --- a/specification/entities/entity-propagation.md +++ b/specification/entities/entity-propagation.md @@ -22,7 +22,7 @@ linkTitle: Entity Propagation * [Error Handling](#error-handling) - [EnvEntityDetector](#enventitydetector) - +
diff --git a/specification/glossary.md b/specification/glossary.md index 05f71534721..d2c5c9a96ab 100644 --- a/specification/glossary.md +++ b/specification/glossary.md @@ -43,7 +43,7 @@ Some other fundamental terms are documented in the [overview document](overview. * [Profile](#profile) * [Profiling](#profiling) - +
diff --git a/specification/logs/README.md b/specification/logs/README.md index 8780e44c585..347cd50e4b8 100644 --- a/specification/logs/README.md +++ b/specification/logs/README.md @@ -33,7 +33,7 @@ path_base_for_github_subdir: - [Specifications](#specifications) - [References](#references) - +
diff --git a/specification/logs/api.md b/specification/logs/api.md index 483e0aeaa7e..cadc022fe73 100644 --- a/specification/logs/api.md +++ b/specification/logs/api.md @@ -26,7 +26,7 @@ aliases: [bridge-api] - [Ergonomic API](#ergonomic-api) - [References](#references) - +
diff --git a/specification/logs/data-model-appendix.md b/specification/logs/data-model-appendix.md index 9cdda207164..ebfe3626799 100644 --- a/specification/logs/data-model-appendix.md +++ b/specification/logs/data-model-appendix.md @@ -21,7 +21,7 @@ the respective exporter documentation if exact details are required. - [Appendix B: `SeverityNumber` example mappings](#appendix-b-severitynumber-example-mappings) - [References](#references) - + ## Appendix A. Example Mappings diff --git a/specification/logs/data-model.md b/specification/logs/data-model.md index 11844d4d3a9..43d22dff6cf 100644 --- a/specification/logs/data-model.md +++ b/specification/logs/data-model.md @@ -41,7 +41,7 @@ weight: 2 - [Example Mappings](#example-mappings) - [References](#references) - +
diff --git a/specification/logs/noop.md b/specification/logs/noop.md index b3cce39a364..921a4d0de0b 100644 --- a/specification/logs/noop.md +++ b/specification/logs/noop.md @@ -17,7 +17,7 @@ linkTitle: No-Op * [Emit LogRecord](#emit-logrecord) * [Enabled](#enabled) - +
diff --git a/specification/logs/sdk.md b/specification/logs/sdk.md index 2ab2362a970..114c64857cb 100644 --- a/specification/logs/sdk.md +++ b/specification/logs/sdk.md @@ -45,7 +45,7 @@ weight: 3 - [Concurrency requirements](#concurrency-requirements) - [Self-observability](#self-observability) - +
diff --git a/specification/logs/supplementary-guidelines.md b/specification/logs/supplementary-guidelines.md index a01c97b76cc..f51bb54eca4 100644 --- a/specification/logs/supplementary-guidelines.md +++ b/specification/logs/supplementary-guidelines.md @@ -24,7 +24,7 @@ extra requirements to the existing specifications. + [Routing](#routing) + [Setup](#setup) - +
diff --git a/specification/metrics/README.md b/specification/metrics/README.md index e02497b2ff0..29bad39bfcd 100644 --- a/specification/metrics/README.md +++ b/specification/metrics/README.md @@ -21,7 +21,7 @@ path_base_for_github_subdir: - [Specifications](#specifications) - [References](#references) - +
diff --git a/specification/metrics/api.md b/specification/metrics/api.md index 4672005788a..0c8bf049e0a 100644 --- a/specification/metrics/api.md +++ b/specification/metrics/api.md @@ -63,7 +63,7 @@ weight: 1 - [Concurrency requirements](#concurrency-requirements) - [References](#references) - +
diff --git a/specification/metrics/data-model.md b/specification/metrics/data-model.md index 75d1260871e..d7503075a3c 100644 --- a/specification/metrics/data-model.md +++ b/specification/metrics/data-model.md @@ -60,7 +60,7 @@ weight: 2 - [References](#references) - [Footnotes](#footnotes) - +
diff --git a/specification/metrics/noop.md b/specification/metrics/noop.md index a602d0bcf07..5f1fe70157a 100644 --- a/specification/metrics/noop.md +++ b/specification/metrics/noop.md @@ -35,7 +35,7 @@ linkTitle: No-Op * [Asynchronous Gauge Observations](#asynchronous-gauge-observations) - [References](#references) - +
diff --git a/specification/metrics/sdk.md b/specification/metrics/sdk.md index 83bb4bdf238..f2c48a28923 100644 --- a/specification/metrics/sdk.md +++ b/specification/metrics/sdk.md @@ -93,7 +93,7 @@ weight: 3 - [Self-observability](#self-observability) - [References](#references) - +
diff --git a/specification/metrics/sdk_exporters/prometheus.md b/specification/metrics/sdk_exporters/prometheus.md index a5a028aa81e..21cba5b38fb 100644 --- a/specification/metrics/sdk_exporters/prometheus.md +++ b/specification/metrics/sdk_exporters/prometheus.md @@ -30,7 +30,7 @@ linkTitle: Prometheus - [Content Negotiation](#content-negotiation) * [Interaction with Translation Strategy](#interaction-with-translation-strategy) - +
diff --git a/specification/metrics/supplementary-guidelines.md b/specification/metrics/supplementary-guidelines.md index 20463be6e04..357258b3c33 100644 --- a/specification/metrics/supplementary-guidelines.md +++ b/specification/metrics/supplementary-guidelines.md @@ -28,7 +28,7 @@ requirements to the existing specifications. - [Asynchronous example: attribute removal in a view](#asynchronous-example-attribute-removal-in-a-view) * [Memory management](#memory-management) - +
diff --git a/specification/overview.md b/specification/overview.md index 336bd100009..7ff079f447a 100644 --- a/specification/overview.md +++ b/specification/overview.md @@ -35,7 +35,7 @@ weight: 1 - [Collector](#collector) - [Instrumentation Libraries](#instrumentation-libraries) - +
diff --git a/specification/profiles/README.md b/specification/profiles/README.md index 8eebcff2bd7..a03189b03fe 100644 --- a/specification/profiles/README.md +++ b/specification/profiles/README.md @@ -20,7 +20,7 @@ path_base_for_github_subdir: - [Specifications](#specifications) - [References](#references) - +
diff --git a/specification/profiles/mappings.md b/specification/profiles/mappings.md index 26a1ad4d402..e932a2bce6d 100644 --- a/specification/profiles/mappings.md +++ b/specification/profiles/mappings.md @@ -9,7 +9,7 @@ This document defines the required attributes of [`Mapping`](../../oteps/profile - [Attributes](#attributes) * [Algorithm for `process.executable.build_id.htlhash`](#algorithm-for-processexecutablebuild_idhtlhash) - + ## Attributes diff --git a/specification/profiles/pprof.md b/specification/profiles/pprof.md index c9af46551ef..7fb6b73668c 100644 --- a/specification/profiles/pprof.md +++ b/specification/profiles/pprof.md @@ -6,7 +6,7 @@ - [Compatibility](#compatibility) - + ## Compatibility diff --git a/specification/resource/README.md b/specification/resource/README.md index 5e506a9aed2..e205e2a8f66 100644 --- a/specification/resource/README.md +++ b/specification/resource/README.md @@ -17,7 +17,7 @@ path_base_for_github_subdir: * [Telescoping](#telescoping) - [Specifications](#specifications) - +
diff --git a/specification/resource/data-model.md b/specification/resource/data-model.md index 03bac35b47d..b2b667f47d7 100644 --- a/specification/resource/data-model.md +++ b/specification/resource/data-model.md @@ -16,7 +16,7 @@ weight: 2 - [Merging Resources](#merging-resources) * [Merging Entities into a Resource](#merging-entities-into-a-resource) - +
diff --git a/specification/schemas/README.md b/specification/schemas/README.md index 736ddcdef64..27cb2ddef8d 100644 --- a/specification/schemas/README.md +++ b/specification/schemas/README.md @@ -27,7 +27,7 @@ path_base_for_github_subdir: - [API Support](#api-support) - [OpenTelemetry Schema](#opentelemetry-schema) - +
diff --git a/specification/telemetry-stability.md b/specification/telemetry-stability.md index 873082e961f..15165d55a7f 100644 --- a/specification/telemetry-stability.md +++ b/specification/telemetry-stability.md @@ -12,7 +12,7 @@ * [Fixed Schema Telemetry Producers](#fixed-schema-telemetry-producers) * [Schema-File Driven Telemetry Producers](#schema-file-driven-telemetry-producers) - +
diff --git a/specification/trace/api.md b/specification/trace/api.md index 307abb89097..0e5d04d9516 100644 --- a/specification/trace/api.md +++ b/specification/trace/api.md @@ -50,7 +50,7 @@ weight: 1 - [Included Propagators](#included-propagators) - [Behavior of the API in the absence of an installed SDK](#behavior-of-the-api-in-the-absence-of-an-installed-sdk) - +
diff --git a/specification/trace/exceptions.md b/specification/trace/exceptions.md index 5662da35ec8..b4e47dd3822 100644 --- a/specification/trace/exceptions.md +++ b/specification/trace/exceptions.md @@ -9,7 +9,7 @@ This document defines how to record exceptions and their attributes. - [Recording an Exception](#recording-an-exception) - [Attributes](#attributes) - + ## Recording an Exception diff --git a/specification/trace/sdk.md b/specification/trace/sdk.md index a1a2566a1cc..59d4585aeab 100644 --- a/specification/trace/sdk.md +++ b/specification/trace/sdk.md @@ -85,7 +85,7 @@ weight: 3 - [Concurrency requirements](#concurrency-requirements) - [Self-observability](#self-observability) - +
diff --git a/specification/trace/tracestate-handling.md b/specification/trace/tracestate-handling.md index 2639f93b5db..1fab0032deb 100644 --- a/specification/trace/tracestate-handling.md +++ b/specification/trace/tracestate-handling.md @@ -18,7 +18,7 @@ linkTitle: TraceState * [Sampling threshold value `th`](#sampling-threshold-value-th) * [Explicit randomness value `rv`](#explicit-randomness-value-rv) - +
diff --git a/specification/trace/tracestate-probability-sampling.md b/specification/trace/tracestate-probability-sampling.md index 718012cbf4b..68ef03bdddd 100644 --- a/specification/trace/tracestate-probability-sampling.md +++ b/specification/trace/tracestate-probability-sampling.md @@ -39,7 +39,7 @@ aliases: [tracestate-probability-sampling-experimental] * [Converting threshold to a sampling probability](#converting-threshold-to-a-sampling-probability) * [Converting threshold to an adjusted count (sampling rate)](#converting-threshold-to-an-adjusted-count-sampling-rate) - +
diff --git a/specification/vendors.md b/specification/vendors.md index dd021d49baf..d24575806a6 100644 --- a/specification/vendors.md +++ b/specification/vendors.md @@ -10,7 +10,7 @@ - [Implements OpenTelemetry](#implements-opentelemetry) - [Qualifications](#qualifications) - + diff --git a/specification/versioning-and-stability.md b/specification/versioning-and-stability.md index 1f4b4c496a7..3da53d22adc 100644 --- a/specification/versioning-and-stability.md +++ b/specification/versioning-and-stability.md @@ -31,7 +31,7 @@ * [Contrib Support](#contrib-support) - [OpenTelemetry GA](#opentelemetry-ga) - + From 83cf8b1e631a79aad97d6280f37ad928172c7da8 Mon Sep 17 00:00:00 2001 From: James Thompson Date: Tue, 16 Jun 2026 02:40:30 +1000 Subject: [PATCH 6/6] More fixes --- development/metrics/config-service.md | 4 +++- oteps/profiles/0239-profiles-data-model.md | 4 +++- specification/logs/api.md | 2 -- specification/logs/supplementary-guidelines.md | 2 -- 4 files changed, 6 insertions(+), 6 deletions(-) diff --git a/development/metrics/config-service.md b/development/metrics/config-service.md index 6559e87d623..0b3bbfe497b 100644 --- a/development/metrics/config-service.md +++ b/development/metrics/config-service.md @@ -1,5 +1,7 @@ # Metric Configuration Service + + - [Metric Configuration Service](#metric-configuration-service) * [Overview](#overview) * [Service Protocol](#service-protocol) @@ -18,7 +20,7 @@ * [Fingerprint Hashing](#fingerprint-hashing) - [Remote Backend](#remote-backend) -Table of contents generated with markdown-toc + ## Overview diff --git a/oteps/profiles/0239-profiles-data-model.md b/oteps/profiles/0239-profiles-data-model.md index 2acf738cecc..4aac8393c82 100644 --- a/oteps/profiles/0239-profiles-data-model.md +++ b/oteps/profiles/0239-profiles-data-model.md @@ -3,6 +3,7 @@ Introduces Data Model for Profiles signal to OpenTelemetry. + * [Motivation](#motivation) * [Design Notes](#design-notes) * [Design Goals](#design-goals) @@ -56,7 +57,8 @@ Introduces Data Model for Profiles signal to OpenTelemetry. * [Repetition of Attribute Keys](#repetition-of-attribute-keys) * [Locations Optimization](#locations-optimization) * [Future Possibilities](#future-possibilities) - + + ## Motivation diff --git a/specification/logs/api.md b/specification/logs/api.md index cadc022fe73..1b57e9a5519 100644 --- a/specification/logs/api.md +++ b/specification/logs/api.md @@ -11,8 +11,6 @@ aliases: [bridge-api]
Table of Contents - - - [LoggerProvider](#loggerprovider) diff --git a/specification/logs/supplementary-guidelines.md b/specification/logs/supplementary-guidelines.md index f51bb54eca4..2758fcc00d9 100644 --- a/specification/logs/supplementary-guidelines.md +++ b/specification/logs/supplementary-guidelines.md @@ -7,8 +7,6 @@ extra requirements to the existing specifications.
Table of Contents - - - [Usage](#usage)