Repository navigation
fix: the blog index gets a Markdown twin and a CollectionPage like the changelog index - #277
Merged
Merged
Conversation
…e changelog index CORE-690 follow-up (13/11/2026 GEO scan: /blog fails G3 no twin, G5 no JSON-LD). check-agent-surface now treats affitor.com/blog as a page with a twin: - the inventory rebuilds /blog.md from the post sources: one line per post, newest first then by slug, dated by the newest post (no more "the blog index has no twin" exception in the sitemap inventory); - the twin is prerendered, in the sitemap with its .md, in llms-full.txt and in markdown-twins.json, like every other twin; - the built /blog page carries one text/markdown alternate link to /blog.md and one CollectionPage whose ItemList is the twin's list, in order. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…e changelog index CORE-690 follow-up: the 13/11/2026 GEO scan found /blog with no Markdown twin (G3) and no JSON-LD (G5); every other public page has both. - src/lib/blog.ts: one description and one order for the index (newest first, then by slug, so same-day posts keep one order). - /blog.md (agent-md blogIndex, prerendered, rewrite /blog.md -> /llms.md/blog): one line per post; the index is an agent page dated by the newest post, so it joins the sitemap with its .md, llms-full.txt and markdown-twins.json, and the middleware answers Accept: text/markdown on /blog with it. - /blog: alternate link text/markdown -> /blog.md and a CollectionPage whose ItemList is the twin's list. - sitemap.ts drops its separate blog index entry (now one of the pages). - markdown-twins.json is the generator's own output. That also adds /changelog/improvements-2026-11-12, which main's committed list had missed since the changelog of 12/11 (the list was not regenerated then). The description already carried an em dash on the live page; unchanged here. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
Review r1 (H1): check-docs-host.mjs still listed /blog as a page without a twin and asserted the twin list leaves it out, so the hosted check failed on every host once the blog index got its twin. Both host checks now expect it: - check-docs-host.mjs: /blog -> /blog.md joins the negotiation pairs, /blog.md joins the not-a-page list, and the twin list must include /blog. - check-docs-host-http.mjs: the proxy host serves /blog.md as text/markdown, and /blog answers the twin for Accept: text/markdown and HTML otherwise, like /changelog (it was "no twin"). Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This branch was successfully deployed
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
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.
What
The blog index gets a Markdown twin and structured data, like the changelog index. Every other public page already has both. The blog index answered
Accept: text/markdownwith HTML and carried no JSON-LD./blog.md: one line per post (date · category · linked title: description), newest first, then by slug./blog.mdto/llms.md/blog..md, inllms-full.txtand in the twin list.Accept: text/markdownon/blogwith it./blog: atext/markdownalternate link to/blog.md, and aCollectionPagewhoseItemListis the twin's list, in the same order.src/lib/blog.ts: one description and one order for the page, its JSON-LD and the twin. Posts of the same day now keep one stable order (by slug).sitemap.ts: drops its separate blog index entry, which is now one of the pages.src/generated/markdown-twins.json: regenerated bygen-llms. Besides/blog, it adds/changelog/improvements-2026-11-12, which the committed list had missed since that entry was published.Note for maintainers: in a clean checkout,
next buildcan fail to resolve@/../.source/server. fumadocs-mdx writes.sourceduring the build, after Turbopack resolves imports. Runningnpx fumadocs-mdxfirst avoids it.Tests first
2eb153a(review round 1): the two host checks expected/blogto have no twin, so the hosted check went red once it got one. Both now expect it:check-docs-host.mjs:/blog→/blog.mdjoins the negotiation pairs,/blog.mdjoins the not-a-page list, and the twin list must include/blog;check-docs-host-http.mjs: the proxy serves/blog.md, and/bloganswers the twin or HTML byAccept.d228475:scripts/check-agent-surface.mjstreats/blogas a page with a twin: the expected/blog.mdis rebuilt from the post sources, and the "blog index has no twin" exception is gone./blogit checks one alternate link to/blog.mdand oneCollectionPagewhose list matches the twin.f62d769.Proof
Round 2, at head
2eb153a:check-docs-host.mjsrun against the pre-change code fails on exactly the 10/blogexpectations: 9 negotiation lines over three hosts, plus the twin list.llms.txtmatch the commit;check-agent-surface.mjs(201 PASS),check-docs-host.mjsandcheck-docs-host-http.mjs(throughnext start).Round 1: both commits were built from a clean archive, with dependencies matching
package-lock.jsonentry for entry andfumadocs-mdxrun first.npm run buildpasses andcheck-agent-surfacefails as intended ("Prerendered twin inventory differs from source":/llms.md/blogdoes not exist yet).npm run buildpasses;markdown-twins.jsonandpublic/docs/llms.txtequal the committed ones;check-agent-surfacepasses, 201 PASS lines, includingPASS blog: twin, source body, sitemap dates, full corpus, twin link and CollectionPage./blog.mdstarts:Order
/blog.mdships first, in the main site.package-lock.json, which is what CI tests.yarn.locklast updated in March, so deploys pick up newer dependencies than the tested ones.🤖 Generated with Claude Code