Description
README, the docs landing page, Getting Started, and Installation currently lead with Grafana Cloud credentials even though OTLP, Prometheus pull, and stdout are all supported. Rebuild the first-ten-minutes journey around a destination choice, define the minimum OpenTelemetry vocabulary, and remove duplicate executable quickstarts that have already drifted.
Acceptance Criteria
- #1 Before destination-specific credentials, readers can distinguish OpenTelemetry, OTLP, a Collector, Grafana Cloud, Prometheus pull, and stdout in plain language
- #2 Grafana OTLP, Prometheus pull, and stdout each reach a first observable signal with a runnable configuration and expected result
- #3 Prometheus guidance covers listener authentication, /metrics verification, scraper verification, and avoidance of duplicate OTLP plus pull ingestion into the same backend
- #4 Each deployment and destination combination has one canonical executable snippet; README and the docs index link to it rather than copying it
- #5 README, docs index, Getting Started, Installation, Comparison, FAQ, and Troubleshooting form one linked route and documented commands pass the repository checker
Definition of Done
- #1 go build ./… && go vet ./… && go test -race ./…
- #2 golangci-lint run
- #3 scripts/regen-generated.sh (only if a generated artifact’s inputs changed)
Implementation Plan
Rebuild the first-ten-minutes route around the frozen destination chooser and starter/check seams; make one canonical runnable snippet per deployment/destination and link README/index/comparison/FAQ/troubleshooting/configuration.
Implementation Notes
Backend-neutral onboarding and canonical deployment snippets are committed in bundled pause snapshot 2cf46446d5c6a7a30ea6f7d0c54d61ec9889d522; the documentation command checker passed. Resume with exact-head CI and live first-signal verification for each destination.
Final evidence: documentation checker passed in the integrated GATE; exact-head CI run 33047209645 succeeded. The Prometheus path reached a first signal end to end through the live listener, Fleet scrape, and backend query; the gateway path delivered an injected OTLP metric during the Alloy drill.
Final Summary
Backend-neutral first-run documentation is committed in 2cf46446d5c6a7a30ea6f7d0c54d61ec9889d522; parked at the live and exact-head verification boundary.
Completion: verified by documentation checks, exact-head CI, and live Prometheus and OTLP gateway signals.