Skip to content

Lead the docs index with the approved agent-native AWS positioning - #66

Merged
flybayer merged 1 commit into
mainfrom
devin/1787275646-docs-index-positioning
Aug 21, 2026
Merged

Lead the docs index with the approved agent-native AWS positioning#66
flybayer merged 1 commit into
mainfrom
devin/1787275646-docs-index-positioning

Conversation

@devin-ai-integration

@devin-ai-integration devin-ai-integration Bot commented Aug 21, 2026

Copy link
Copy Markdown
Contributor

Summary

Aligns the docs index page with the current canonical positioning (agent-native cloud infrastructure platform, AWS scope today), which the previous copy predated.

  • Title/H1: Agent-native cloud infrastructure for AWS (renders as Agent-native cloud infrastructure for AWS - Ravion Docs)
  • Description: Learn how to provision, deploy, and operate production-grade applications in your AWS account with Ravion’s agent-native cloud infrastructure platform.
  • Opens with the canonical short company description, adds DevOps to the operating audience, and states that AWS is supported today with other clouds planned plus telemetry/native AWS tools are connected, not replaced.
  • Drops superseded phrasing (cloud command center, no DevOps hire needed, nothing to migrate off later) in favor of leverage, ownership, extensibility, and incremental adoption. DevOps retains control of Terraform, modules, permissions, policies, pipelines, approvals, and the AWS account.
  • Agent-native is stated concretely as discover, plan, act, verify, recover via structured config, CLI, API, and MCP with governed permissions and reviewable plans.

Canonical URL, indexability, navigation, and the og:image/twitter:image frontmatter are unchanged. The OG banner headline itself is generated in ravionhq/flightcontrol (packages/web/server/routes/og/[...path].png.ts) and is updated in a companion PR.

Verified locally: pnpm validate, node scripts/sync-og-images.mjs --check, node scripts/check-docs-seo-invariants.mjs, node --test scripts/*.test.mjs, plus rendered HTML inspection of title, meta/OG/Twitter descriptions, single H1, and self-canonical.

Link to Devin session: https://app.devin.ai/sessions/c7fab60b65224fc0a361b9ff875d5ce3

Greptile Summary

Updates the documentation landing page to use the approved agent-native AWS positioning.

  • Replaces superseded platform messaging with AWS-focused ownership, governance, and incremental-adoption language.
  • Describes agent workflows through structured configuration, CLI, API, and MCP interfaces.
  • Updates audience-specific sections and assistant prompts while preserving existing navigation and social-image metadata.

Confidence Score: 5/5

The PR appears safe to merge with no actionable issues identified.

The change is confined to documentation positioning and preserves the existing page structure, links, component usage, and social-image metadata.

Important Files Changed

Filename Overview
index.mdx Refreshes landing-page metadata and marketing copy without introducing a concrete functional or documentation defect.

Reviews (1): Last reviewed commit: "Lead the docs index with the approved ag..." | Re-trigger Greptile

@devin-ai-integration

Copy link
Copy Markdown
Contributor Author

🤖 Devin AI Engineer

I'll be helping with this pull request! Here's what you should know:

✅ I will automatically:

  • Address comments on this PR. Add '(aside)' to your comment to have me ignore it.
  • Look at CI failures and help fix them

Note: I can only respond to comments from users who have write access to this repository.

⚙️ Control Options:

  • Disable automatic comment, CI, and merge conflict monitoring

@mintlify

mintlify Bot commented Aug 21, 2026

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
Ravion 🟢 Ready View Preview Aug 21, 2026, 1:29 AM

@flybayer
flybayer merged commit 389a688 into main Aug 21, 2026
6 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