Skip to content

Rework getting-started Explore cards into a capability map - #2122

Merged
strawgate merged 4 commits into
mainfrom
docs/getting-started-cards-v2
Jul 25, 2026
Merged

strawgate merged 4 commits into
mainfrom
docs/getting-started-cards-v2

Conversation

@strawgate

@strawgate strawgate commented Jul 25, 2026 •

Copy link
Copy Markdown
Contributor

What

Reworks the Explore section of the getting-started hub so it maps Logfire's breadth and differentiators instead of a grab-bag of four links.

Quickstarts (unchanged) — the three action cards: send your first trace, trace AI & LLM calls, let an AI agent set it up.

Explore (reworked) — six capability cards:

  • Watch it live (Live view)
  • Query with SQL — surfaces the SQL Workbench (no proprietary query language)
  • Dashboards and alerts
  • Evaluate and ship AI features — evals, prompts, AI gateway
  • Metrics and infrastructure — hosts, Kubernetes, Docker
  • Integrations — 40+ one-line

"Choose your path" moves from a card into the intro line (a router-to-a-router doesn't need a card).

Notes

  • New card icons (sql, evals, metrics) come from pydantic/unified-docs#115; until that merges they render as chips without a glyph. All other icons already ship.
  • Doc-example tests pass; no em-dashes; all links resolve to existing pages.

Review in cubic

Replace the Explore grab-bag with cards that map Logfire's breadth and
differentiators: watch it live, query with SQL, dashboards & alerts,
evaluate & ship AI features, metrics & infrastructure, and integrations.
Keep the three Quickstart action cards, and move 'choose your path' into
the intro line rather than a card.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@coderabbitai

coderabbitai Bot commented Jul 25, 2026 •

Copy link
Copy Markdown

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: f69f7810-01cc-4cd3-84f5-6c86cb466192

📥 Commits

Reviewing files that changed from the base of the PR and between 95a7888 and 32b3dce.

📒 Files selected for processing (1)
  • docs/index.md
🔗 Linked repositories identified

CodeRabbit considers these linked repositories for cross-repo context during reviews:

  • pydantic/logfire (manual)
  • pydantic/pydantic-ai (manual)
  • pydantic/platform (auto-detected)
  • pydantic/pydantic (auto-detected)
🚧 Files skipped from review as they are similar to previous changes (1)
  • docs/index.md

📝 Walkthrough

Walkthrough

Updated the “Get started with Logfire” page with role-based guidance for new users. Revised the Explore cards with new and updated links for live viewing, SQL queries, dashboards and alerts, AI evaluations, metrics, and integrations, while removing the previous “choose your path” card.

Possibly related PRs

  • pydantic/logfire#2102: Introduces the role-based getting-started pages and related navigation targets referenced by this landing-page update.
  • pydantic/logfire#2114: Also revises the docs/index.md onboarding flow and Explore links.
🚥 Pre-merge checks | ✅ 4
✅ Passed checks (4 passed)
Check name Status Explanation
Title check ✅ Passed The title clearly reflects the main change: reworking the getting-started Explore cards into a capability map.
Description check ✅ Passed The description is on-topic and matches the reworked Explore section and related landing-page changes.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch docs/getting-started-cards-v2

Comment @coderabbitai help to get the list of available commands.

@cubic-dev-ai cubic-dev-ai Bot left a comment •

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

All reported issues were addressed across 1 file

Reply with feedback, questions, or to request a fix.

Re-trigger cubic

Comment thread docs/index.md Outdated
@github-actions

github-actions Bot commented Jul 25, 2026 •

Copy link
Copy Markdown
Contributor

Docs Preview

latest https://logfire-pr2122-pydantic-docs-preview.pydantic.workers.dev/logfire/
this commit (95a7888) https://a6d0cbb8-pydantic-docs-preview.pydantic.workers.dev/logfire/

latest is a stable per-PR link that always points at the newest build — use it in docs or when sharing. this commit is pinned to 95a7888. Re-add the trigger:docs label to rebuild for a newer commit.

guides/web-ui/evals.md is removed by the Evals consolidation (#2123);
link the capability-map Evaluate card at evaluate/overview.md, which
survives that consolidation, so the two PRs compose cleanly.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@docs/index.md`:
- Around line 46-48: Update the landing-page link text in the Evaluate and ship
AI features entry to spell out “AI evaluations” instead of “evals,” while
leaving the surrounding description and link target unchanged.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 29a74d0f-23c1-484b-b955-ffa5b55dd2e8

📥 Commits

Reviewing files that changed from the base of the PR and between 3fe8e85 and 95a7888.

📒 Files selected for processing (1)
  • docs/index.md
🔗 Linked repositories identified

CodeRabbit considers these linked repositories for cross-repo context during reviews:

  • pydantic/logfire (manual)
  • pydantic/pydantic-ai (manual)
  • pydantic/platform (auto-detected)
  • pydantic/pydantic (auto-detected)

Comment thread docs/index.md Outdated
Landing-page cards introduce a term to new readers, so use the full word
rather than the 'evals' shorthand (docs style guide).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@strawgate
strawgate enabled auto-merge (squash) July 25, 2026 16:58
@strawgate
strawgate merged commit 8cd7540 into main Jul 25, 2026
17 checks passed
@strawgate
strawgate deleted the docs/getting-started-cards-v2 branch July 25, 2026 17:06
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