Skip to content

DOCS-1869 - GEO fixes for the Page Backlog report - #7103

Draft
JV0812 wants to merge 7 commits into
mainfrom
DOCS-1869
Draft

DOCS-1869 - GEO fixes for the Page Backlog report#7103
JV0812 wants to merge 7 commits into
mainfrom
DOCS-1869

Conversation

@JV0812

@JV0812 JV0812 commented Sep 4, 2026

Copy link
Copy Markdown
Collaborator

Purpose of this pull request

This pull request applies GEO (Generative Engine Optimization) fixes to the 21 pages listed in the Profound "Page Backlog (ranked by opportunity)" report, to improve AI citation share:

  • Strengthened BLUF (bottom-line-up-front) opening paragraphs on every page
  • Added an FAQ section to every page (at least 5 items each), including report-matched prompts from the "Prompts with no Sumo doc page cited" table for cloud-soar/introduction.md, cse/get-started-with-cloud-siem/intro-for-analysts.md, and cse/automation/about-automation-service-and-cloud-siem.md
  • Converted genuine overview/concept headings to question form, leaving procedural "Create X"/"Configure X" headings and UI labels untouched to match existing site convention
  • Added/refreshed keywords frontmatter on all 21 pages

No pages were split or newly created, and no sidebar or redirect changes were made — everything is an in-place edit to existing pages. Page-splitting for the largest pages (cloud-soar/introduction.md, both intro-for-* pages, kubernetes.md, metric-query-best-practices.md, cloud-siem-automation-examples.md, sumo-logic-flex-accounts.md, cloud-infrastructure-security-for-aws.md) is deferred to a future follow-up under DOCS-1869.

Select the type of change

  • Minor Changes - Typos, formatting, slight revisions
  • Update Content - Revisions, updating sections
  • New Content - New features, sections, pages, tutorials
  • Site and Tools - .clabot, version updates, maintenance, dependencies, new packages for the site (Docusaurus, Gatsby, React, etc.)

Ticket (if applicable)

https://sumologic.atlassian.net/browse/DOCS-1869

JV0812 and others added 7 commits September 4, 2026 12:38
…h 1/3)

Apply BLUF openings, question-style headings, FAQ sections, and keywords
frontmatter to the 7 highest-opportunity Security/SOAR/Compliance pages
from the GEO Page Backlog report, to improve AI citation share.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Apply BLUF openings, question-style headings, FAQ sections, and keywords
frontmatter to the 8 Cloud SIEM/CSE pages from the GEO Page Backlog
report, to improve AI citation share.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
…batch 3/3)

Apply BLUF openings, FAQ sections, and keywords frontmatter to the 6
Log analytics/Metrics/Manage pages from the GEO Page Backlog report,
to improve AI citation share.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
…dditions

Rewrite new FAQ headings from first person ("Can I...", "How do I...")
to second person ("Can you...", "How do you...") per style convention,
and rewrite the three renamed section headings from "How do I X?" to
"How to X" to match this repo's GEO heading format.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Add GEO Backlog report-matched prompts as FAQ entries on
cloud-soar/introduction.md, top up every Security/SOAR/Compliance page
to at least 5 FAQ items, and convert genuine overview/concept headings
to question form (leaving procedural "Create X" and UI-label headings
untouched to match existing site convention).

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Add GEO Backlog report-matched prompts as FAQ entries on
intro-for-analysts.md and about-automation-service-and-cloud-siem.md,
top up every Cloud SIEM/CSE page to at least 5 FAQ items, and convert
genuine overview/concept headings to question form.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Top up every Log analytics/Metrics/Manage page to at least 5 FAQ
items (including a new 5-item FAQ section for product-list-a-l.md,
which had none), convert genuine overview/concept headings to
question form, and fix the one cross-file anchor reference affected
by a heading rename.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
@JV0812 JV0812 self-assigned this Sep 4, 2026
@cla-bot cla-bot Bot added the cla-signed Contributor approved, listed in .clabot file label Sep 4, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

cla-signed Contributor approved, listed in .clabot file

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant