docs: search/answer-engine optimizations, sidebar reorg, dependency upgrades - #686
Merged
Merged
Conversation
Site-wide search and answer-engine optimizations for typegraph.dev: - Alias /sitemap.xml to the real generated sitemap with a proper HTTP redirect (not a static meta-refresh page, which would have served invalid sitemap content to crawlers). - Add robots.txt with an explicit Sitemap: line and per-bot Allow rules covering the major AI/answer-engine crawlers, rather than relying on ambiguous implicit defaults. - Add site-wide Organization, WebSite, and Person structured data (JSON-LD), cross-linked by stable @id references. - Add a genuine FAQ section to the homepage, backed by FAQPage structured data tied to the same entity graph. - Add About/Contact links to the homepage footer. Also in this change: - Reorder the Guides sidebar so Backend Setup leads the section, and move Authoring an engine profile into Reference alongside the other backend-internals pages. - Upgrade the docs site's Astro toolchain and related dependencies (astro, the @astrojs/* integrations, Tailwind, the Astro ESLint parser/plugin, prettier-plugin-astro, and Cloudflare Workers test tooling), including two major-version bumps in the lint/format toolchain. wrangler was bumped alongside @astrojs/cloudflare since the new adapter version requires a newer wrangler than we had. Verified via full-repo typecheck/lint/build, the Cloudflare Workers test lane, and a live check of Starlight's redesigned mobile menu.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Search and answer-engine optimizations for typegraph.dev, a sidebar reorganization, and an Astro toolchain upgrade for the docs site.
Discoverability
/sitemap.xmlnow redirects (a real HTTP 301, not a static page) to the actual generated sitemap, androbots.txtis new: it carries aSitemap:line and explicit per-crawlerAllow/Disallowrules for the major AI/answer-engine bots instead of leaving them to an ambiguous implicit default.Structured data and content
The site now publishes site-wide Organization, WebSite, and Person structured data (JSON-LD), cross-linked by stable
@idreferences so the entities read as one connected graph rather than disconnected fragments. The homepage gained a genuine FAQ section backed by FAQPage structured data tied into the same entity graph, plus About/Contact links in the footer.Sidebar
Backend Setup now leads the Guides section. Authoring an engine profile moved out of Guides into Reference, next to Architecture, since it's backend-internals material rather than a getting-started guide.
Dependency upgrade
Bumped the docs site's Astro toolchain and related tooling:
astro, the@astrojs/*integrations, Tailwind, the Astro ESLint parser/plugin,prettier-plugin-astro, and the Cloudflare Workers test tooling — including two major-version bumps in the lint/format toolchain (astro-eslint-parser/eslint-plugin-astromoved to Astro's Rust compiler backend;prettier-plugin-astrois a full rewrite on the same).wranglerwas bumped alongside@astrojs/cloudflaresince the new adapter version requires a newer wrangler than we had — not originally in scope, but required.Also removes API compatibility exceptions for APIs already published in v0.58.0. Those exceptions no longer match a base-to-head change and were causing the stale-ledger CI check to fail.