Simplify docs

[canercidam]

No description provided.

[claude]

Claude finished @canercidam's task in 1m 44s —— View job

---

Claude PR Review

• Review PR diff
• Check README changes
• Check for broken links/references
• Post review feedback

Summary

Docs cleanup PR renaming "Telemetry" → "Metrics", dropping the README "Internals" section and docs/architecture.md. Small scope, low risk — one issue worth fixing.

Findings

Broken link / stale terminology — docs/internals/writing_components.md:50

This PR renames docs/telemetry.md → docs/metrics.md but leaves behind a reference in writing_components.md:

**Note**: If a port is named `"metrics"`, it will be automatically recognized as a Prometheus endpoint and tracked by the telemetry stack. See [telemetry.md](../telemetry.md) for more information.

The link ../telemetry.md is now dead and the wording "telemetry stack" is inconsistent with the new "Metrics" naming. Inline comment posted with a [Fix this →] link.

Pre-existing nits in docs/metrics.md (not introduced by this PR, carried over from telemetry.md — not worth fixing unless you're touching the file again): leading blank line before the # Metrics H1 (line 1), and missing blank line between ## Usage and the following paragraph (line 14).
• Branch: claude/pr-416-20260422-1845

[claude]

Stale link not updated in this PR: docs/internals/writing_components.md:50 still references ../telemetry.md, which no longer exists after the rename. It should point to ../metrics.md, and the inline text ("telemetry stack") should also be updated to match the new naming.

**Note**: If a port is named `"metrics"`, it will be automatically recognized as a Prometheus endpoint and tracked by the telemetry stack. See [telemetry.md](../telemetry.md) for more information.

Fix this →