w3c / w3c/trace-context

Be consistent with normative / non-normative sections

Open
#396 2 comments 0 reactions 1 assignee View on GitHub

@SergeyKanzhelev is already working on this.

Since Jun 30, 2026.

Editorial privacy-needs-resolution todo
Dominant language
Python
Stars
510
Forks
80
PR merge metrics
No merged PRs in 30d

Description

See https://lists.w3.org/Archives/Public/public-trace-context/2020Feb/0004.html

A few sections of the document are marked as non-normative, but then their subsections include many direct normative requirements. The Problem Statement and Solution sections (which read to me as non-normative overviews) are not marked as non-normative. I don’t really have any strong feelings about use of non-normative section headers, I’m just passing on that the distinctions in the current spec are confusing.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.