Skip to content

docs: refresh homepage and prune navigation#160

Merged
jayhack merged 3 commits into
developfrom
docs/homepage-and-nav-refresh
Jun 23, 2026
Merged

docs: refresh homepage and prune navigation#160
jayhack merged 3 commits into
developfrom
docs/homepage-and-nav-refresh

Conversation

@jayhack

@jayhack jayhack commented Jun 22, 2026

Copy link
Copy Markdown
Contributor

Summary

Refreshes the marketing homepage and trims the docs navigation down to what we still support.

Homepage (site/app/page.tsx)

Above the fold now emphasizes:

  • A fast, in-memory codebase index that captures more than the AST (imports, exports, usages, references).
  • Backed by tree-sitter (with heavy indexes moving into Rust for scale).
  • Optimized for coding agents.
  • An inline delete_dead_code.py example (loops codebase.functions, removes those with no usages, then commit()).
  • The uvx graph-sitter command pattern (parse, then transform … --check/--write).

The explicit graph visualization was dropped in favor of the dead-code script. The existing Explore nav link is preserved. Below the fold: three use cases (large-scale reorganization, dead-code monitoring & deletion, codebase visualization) and the uvx graph-sitter command surface.

Navigation cleanup

  • Tutorials removed: MCP Server, Documentation, Code Research Agent, Neo4j Graph.
  • Introduction removed: Advanced Settings, Community, IDE Usage, AI Integration; also dropped LLM Integration (building-with-graph-sitter/calling-out-to-llms).
  • Broken sections removed: use-cases, organizations, users (and pruned from the section order in site/lib/docs.ts).
  • Installation rewritten to focus on uvx.
  • Overview pinned to the top of Introduction via a new sidebarOrder frontmatter field (supported in site/lib/docs.ts).
  • Fixed the resulting dead links across remaining intro/building-with/tutorial pages.

Note

A duplicate docs/graph-sitter/ section (mirrors Introduction) still links to some removed pages; left untouched as it's out of scope for this pass.

Test plan

  • npm run build in site/ passes (TypeScript checks + 287 static pages, incl. / and /explore).
  • Visual review of the homepage above the fold.
  • Spot-check the Introduction sidebar (Overview first) and confirm removed sections are gone.

Made with Cursor

Rework the site homepage to emphasize the fast in-memory codebase index
(beyond the AST), tree-sitter backing, an inline dead-code deletion
example, the uvx command pattern, and coding-agent use cases.

Prune navigation: remove MCP/documentation/code-research/neo4j tutorials,
drop advanced-settings/community/ide-usage/AI+LLM integration intro pages,
delete the broken use-cases/organizations/users sections, focus
installation on uvx, pin Overview to the top of Introduction, and fix the
resulting dead links.

Co-authored-by: Cursor <cursoragent@cursor.com>
@jayhack jayhack requested a review from a team as a code owner June 22, 2026 21:54
@jayhack jayhack requested review from matthieualouis and removed request for a team June 22, 2026 21:54
@vercel

vercel Bot commented Jun 22, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
graph-sitter Ready Ready Preview, Comment Jun 23, 2026 3:36pm

Request Review

@mintlify

mintlify Bot commented Jun 22, 2026

Copy link
Copy Markdown

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

Project Status Preview Updated (UTC)
graph-sitter 🔴 Failed Jun 22, 2026, 9:56 PM

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

@jayhack jayhack merged commit 75527bb into develop Jun 23, 2026
1 of 2 checks passed
@jayhack jayhack deleted the docs/homepage-and-nav-refresh branch June 23, 2026 15:35
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