Skip to content

Clarify and simplify integrations overview - #39204

Draft
evazorro wants to merge 1 commit into
masterfrom
eparish/rewrite-integrations-overview
Draft

Clarify and simplify integrations overview#39204
evazorro wants to merge 1 commit into
masterfrom
eparish/rewrite-integrations-overview

Conversation

@evazorro

@evazorro evazorro commented Aug 14, 2026

Copy link
Copy Markdown
Contributor

What does this PR do? What is the motivation?

Rewrites the overview on the integrations getting-started page to be simpler, clearer, and more direct.

I was trying out using different models to rewrite a section of the docs (as part of the team's AI Friday) and liked this rewrite quite a bit, so wanted to keep it.

What changed:

  • Cut the abstract definition from the first paragraph; too wordy and abstract.
  • Made the three bullets parallel; each now opens with how the integration is set up, then how it collects data, then examples.
  • Moved the note to the end because it interrupted the flow.
  • Framed the custom check as a fallback, not an equal option (you should only really create one if no suitable integration exists)
  • Minor style fixes

Merge readiness

  • Ready for merge

AI assistance

Written by Claude, approved by me

Additional notes

@github-actions

Copy link
Copy Markdown
Contributor

Preview links (active after the build_preview check completes)

Modified Files

@jhgilbert jhgilbert added the astro-reorg-no-conflicts Needs manual conflict resolution after replatforming reorg label Aug 14, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

astro-reorg-no-conflicts Needs manual conflict resolution after replatforming reorg

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants