From 945e05544469c39f0cd1c4a0095e8eda2948202a Mon Sep 17 00:00:00 2001 From: Daniel McCoy Stephenson Date: Mon, 5 Oct 2026 21:26:54 -0600 Subject: [PATCH] Point the usage-reporting link at danielstephenson.dev/usage-reporting The old link went to a section of a private repository and 404'd for everyone following it from a program's startup notice. Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01BZQMN1M5hQKfUpPwDkMjqd --- CHANGELOG.md | 10 ++++++++++ README.md | 8 +++----- trace-client.ts | 2 +- 3 files changed, 14 insertions(+), 6 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 3fb2eab..c00a7b0 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -4,6 +4,16 @@ All notable changes to this project are recorded here. The version in the header comment of `trace-client.ts` is the one consumers vendor; check it against this file to see what a re-vendor would bring. +## [Unreleased] + +- The usage-reporting details link in the `TraceClient` doc comment and the + README's startup-notice example now points at + https://danielstephenson.dev/usage-reporting. The old link pointed into a + private repository, so anyone following it got a 404. Programs that copied + the README example should update the URL in their own notice. +- The README's Keys section no longer links to a decision record in that + private repository. + ## 0.4.0 — 2026-10-03 A random per-installation ID, matching trace-client-java 0.5.0, so the diff --git a/README.md b/README.md index 0734bd9..103e57c 100644 --- a/README.md +++ b/README.md @@ -185,7 +185,7 @@ this order — so a program can say so in its startup notice: ```ts console.log(trace.enabled - ? "Usage reporting is on. Details: https://github.com/Stephenson-Software/trace#usage-reporting" + ? "Usage reporting is on. Details: https://danielstephenson.dev/usage-reporting" : `Usage reporting is off (${trace.disabledReason}).`); ``` @@ -287,10 +287,8 @@ tolerated. A key identifies the program to the server and lets the operator revoke it; it is scoped to *reporting only*. Because it ships inside the program — in a public repository, in a browser-adjacent runtime — it cannot prove anything; -treat trace data as best-effort telemetry, which is what it is. The reasoning -is written up in the trace repository's -[decision record on per-program write keys](https://github.com/Stephenson-Software/trace/blob/main/docs/decisions/0001-per-program-write-keys.md). -Ask the trace operator for a key for your program. +treat trace data as best-effort telemetry, which is what it is. Ask the +trace operator for a key for your program. ## Building diff --git a/trace-client.ts b/trace-client.ts index 28f1f6f..2dce8f3 100644 --- a/trace-client.ts +++ b/trace-client.ts @@ -125,7 +125,7 @@ export interface ReportOptions { * `"config"` or `"no key"`; `null` when on) so the program can say so in its * notice. Programs that run on other people's machines should expose that * switch in their settings and say so once, pointing at - * https://github.com/Stephenson-Software/trace#usage-reporting. + * https://danielstephenson.dev/usage-reporting. * * Every event carries the program's own version as the tag `version` -- the * required `version` option -- so a `page-view` or `command` event can be