Skip to content

Drop the one dangling design-doc citation - #20

Merged
fylorn merged 1 commit into
mainfrom
dev
Sep 14, 2026
Merged

fylorn merged 1 commit into
mainfrom
dev

Conversation

@fylorn

@fylorn fylorn commented Sep 14, 2026

Copy link
Copy Markdown
Contributor

What

One comment in crates/common/src/errors.rs cited thinkwatch-core DESIGN §9.3 — a document that exists in none of the three repositories. The same cleanup just landed in ThinkWatchProject/ThinkWatch-Core#8 and ThinkWatchProject/ThinkWatch-Lite#12; this is the single site here.

The citation goes, the reasoning stays — the sentence already said the whole thing: the shared layer must not know this crate's error taxonomy, which is why tw-crypto carries its own SecretError.

What was deliberately left alone

Every other § in this repo is a real citation and stays: RFC 6749, 6585, 7231, 7591, 7636, 8414, 9728, the MCP authorization spec, and LICENSING.md §Tier Determination (that section does exist in LICENSING.md). Those point at documents a reader can actually open.

Verification

cargo fmt --all -- --check, cargo clippy --workspace --all-targets -- -D warnings, and 635 tests pass locally.

🤖 Generated with Claude Code

A comment in `crates/common/src/errors.rs` cited `thinkwatch-core
DESIGN §9.3`, a document that exists in none of the three repositories.
The same cleanup just landed in Core and Lite; this is the only site
here.

The sentence already carried the whole argument — the shared layer must
not know this crate's error taxonomy, which is why `tw-crypto` has its
own `SecretError` — so only the pointer goes.

Every other section reference in this repo is left alone, because they
are real: RFC 6749, 6585, 7231, 7591, 7636, 8414 and 9728, the MCP
authorization spec, and `LICENSING.md §Tier Determination`, which is an
actual heading in an actual file here.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@fylorn
fylorn merged commit ad99449 into main Sep 14, 2026
7 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant