docs: SEO optimization for AG Grid enterprise docs#6705
Conversation
Target the "AG Grid + Python" query space so Reflex surfaces for AG Grid /
ag-grid / aggrid keyword variations, grounded in Ahrefs data (ag grid 5.5K,
aggrid 1K, ag-grid 900, ag grid react 300, plus low-difficulty feature terms
ag grid pagination/pivot KD 0).
- index.md: keyword-rich meta description and an intro that naturally covers
AG Grid / ag-grid / aggrid, React data grid, Python, and pandas DataFrame.
- Sub-pages (column-defs, pivot-mode, cell-selection, theme, model-wrapper,
value-transformers, aligned-grids): add page-specific meta descriptions
mapped to their feature keywords (ag grid column definitions, ag grid pivot,
ag grid cell selection, etc.).
- manual_titles: give every AG Grid page a keyword-rich <title> ("AG Grid ...
in Python"). The overview page previously rendered as "Index" because the
normal doc path derives titles from the filename, not frontmatter title.
Content-only plus one manual_titles dict addition; enterprise docs render via
the normal doc path, so meta descriptions flow through extract_doc_description
with no parser/infra changes needed.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Ez43BK9AhhMPMdRcFmMEPR
Merging this PR will not alter performance
Comparing Footnotes
|
Greptile SummaryThis PR adds keyword-rich
Confidence Score: 5/5Safe to merge — changes are limited to frontmatter and a single Python dict; no logic paths are affected. All changes are additive: frontmatter fields and dict entries read at build time to populate meta and title tags. The manual_titles keys correctly match the virtual doc paths used in the lookup, and extract_doc_description already supports meta_description frontmatter verbatim. Three descriptions land slightly over Google's ~160-char SERP truncation point, but this affects only display in search results, not runtime behavior or build correctness. pivot-mode.md, theme.md, and model-wrapper.md have meta descriptions exceeding 160 characters. Important Files Changed
Reviews (2): Last reviewed commit: "docs: trim AG Grid meta descriptions to ..." | Re-trigger Greptile |
index.md and column-defs.md meta descriptions exceeded Google's ~160-char SERP display threshold and would be truncated mid-sentence. Trim both to keep the full text visible (review nits). Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01Ez43BK9AhhMPMdRcFmMEPR
Summary
SEO pass over the AG Grid enterprise docs (
/docs/enterprise/ag-grid/+ 7 sub-pages) so Reflex surfaces for AG Grid + Python searches. Grounded in Ahrefs:ag grid(5.5K/mo, KD 20),aggrid(1K),ag-grid(900),ag grid react(300, KD 4), plus low-difficulty feature termsag grid pagination/ag grid pivot(KD 0). The Python-specific variants (ag grid python,aggrid python,python data grid) are low-volume but exactly the audience — so the goal is to cover the variations across title, meta description, and body.Type of change
What changed
index.md— keyword-rich meta description; intro rewritten to naturally cover AG Grid / ag-grid / aggrid, "React data grid," "Python," and "pandas DataFrame."column-defs,pivot-mode,cell-selection,theme,model-wrapper,value-transformers,aligned-grids) — page-specific meta descriptions mapped to their feature keywords (ag grid column definitions,ag grid pivot,ag grid cell selection, …).manual_titles— every AG Grid page now gets a keyword-rich<title>("AG Grid … in Python"). The overview page previously rendered as "Index · Ag_Grid · Reflex Docs" because the normal doc path derives titles from the filename, not frontmattertitle.Why no infra/parser changes (unlike #6703 / #6704)
Enterprise docs render via the normal doc path, which already runs
extract_doc_description— so frontmattermeta_descriptionflows through with nomulti_docs/parser changes. No page here hascomponents:frontmatter, and no new routes are added, so neither the duplicate-route nor the changelog check applies. The only non-markdown change is adding entries to themanual_titlesdict.Testing
ruff check/ruff format --checkpass on the changed Python file.pivot-mode.md); meta descriptions 150–211 chars.pytest/reflex compilein the sandbox (pinned Python toolchain unavailable). Please let CI validate the docs build.Notes
The head term
ag grid(5.5K) is dominated by ag-grid.com; realistic near-term wins are the Python/feature long-tail (ag grid python,aggrid python,ag grid react,ag grid pagination,ag grid pivot). This is independent of #6703/#6704 — no shared-infra overlap, so it can merge in any order.🤖 Generated with Claude Code
https://claude.ai/code/session_01Ez43BK9AhhMPMdRcFmMEPR
Generated by Claude Code