Skip to content

[Docs] Rewrite article descriptions as search summaries - #3132

Merged
kostichs merged 5 commits into
mainfrom
DOC-2632
Oct 3, 2026
Merged

kostichs merged 5 commits into
mainfrom
DOC-2632

Conversation

@kostichs

@kostichs kostichs commented Oct 3, 2026 •

Copy link
Copy Markdown
Collaborator

What changed

Rewrote the frontmatter description on 650 articles into a search summary: one sentence, 140 characters maximum, without Portal, API, or Terraform. The article bodies are unchanged.

Jira: https://jira.gcore.lu/browse/DOC-2632

Files changed

  • 650 *.mdx articles — replaced the description line
  • scripts/generate_seo_descriptions.py — drafts descriptions through the preprod AI Gateway
  • scripts/test_generate_seo_descriptions.py — checks length, banned words, and line endings

TODO before publishing

  • Writer review of the generated summaries
  • Writer review and approval

@mintlify

mintlify Bot commented Oct 3, 2026 •

Copy link
Copy Markdown
Contributor

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

Project Status Preview Updated
gcore 🟢 Ready View Preview Oct 3, 2026, 11:39 AM

💡 Tip: Enable Automations to automatically generate PRs for you.

@kostichs
kostichs marked this pull request as ready for review October 3, 2026 11:37
@kostichs
kostichs merged commit a931f30 into main Oct 3, 2026
7 of 8 checks passed
@kostichs
kostichs deleted the DOC-2632 branch October 3, 2026 15:18
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