docs: add canonical links and Organization JSON-LD to both sites

[vihar]

Summary

Item 2 from the is-agentic scan of docs.plane.so (follow-up to #508, independent of it).

docs.plane.so had no <link rel="canonical"> (developers.plane.so already injected one per page), and neither site published structured data. The scan flagged three findings for this: Metadata completeness (partial), JSON-LD structured data (fail), Organization schema completeness (fail).

Change. New packages/theme/src/seo.ts, exported as @plane/docs-theme/seo (build-time only — nothing ships to the browser):

• siteJsonLd(site) → one <script type="application/ld+json"> head entry with a shared Organization for Plane (name, url, logo, sameAs GitHub + X, contactPoint for support@ and sales@) plus a WebSite node for the specific site. Keeping the Organization in the theme means both sites publish the same identity and it can't drift.
• canonicalLink(origin, pageData) → per-page canonical mirroring cleanUrls (dir/page.md → /dir/page, index.md → /), skipped when frontmatter already sets one.

apps/docs gains a transformPageData for the canonical; apps/developer-docs swaps its inline canonical logic for the helper. Both add siteJsonLd(...) to head.

No postal address is included — say if one should be published.

Verification

• pnpm check:types / check:format pass; both apps build.
• Rendered output checked in both dist/s: exactly one canonical and one JSON-LD per page; root canonical is https://docs.plane.so/, nested pages have no trailing slash, and /self-hosting/manage/upgrade-from-0.13.2-0.14.0 is correct. The JSON-LD parses (Organization Plane + WebSite …, 2 contact points).
• After deploy: https://validator.schema.org/ on either homepage, or

  curl -s https://docs.plane.so/ | grep -oE '<link rel="canonical"[^>]*>|application/ld\+json'
  

Checklist

• 1. Markdown negotiation — fix: serve markdown via routing middleware for Accept: text/markdown #508
• 2. Canonical + Organization JSON-LD — this PR
• 3. Markdown body on the 404 page pointing at /llms.txt and /sitemap.xml
• 4. Publish openapi.json on developers.plane.so and link it from llms.txt
• 5. Re-run npx is-agentic on both hosts

🤖 Generated with Claude Code

https://claude.ai/code/session_01CsPSwTnpsEb5c5Ud2CLrL8

[vercel]

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

Project	Deployment	Actions	Updated (UTC)
developer-docs	Ready	Preview	Aug 21, 2026 8:06pm
docs	Ready	Preview	Aug 21, 2026 8:06pm

[coderabbitai]

Warning

Review limit reached

@vihar, you've reached your PR review limit, so we couldn't start this review.

Next review available in: 49 minutes

Limit details: You’ve used the included review currently available.

You've used all free OSS reviews for now. Wait for the free limit to reset to keep reviewing this public repository.

How can I continue?

Wait for the limit to reset, then comment @coderabbitai review or push new commits to the PR.

An organization admin can change what happens after included review limits in Billing.

How do review limits work?

CodeRabbit enforces per-developer PR review limits within each organization.

For paid Pro and Pro+ reviews, CodeRabbit uses a developer's included PR review attempts over the past 7 days to set the current hourly allowance. At typical activity levels, the full plan allowance applies. Higher sustained activity can lower the allowance until earlier attempts leave the 7-day window.

Please refer docs for additional details.

Review details

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 9a28b499-7ef4-4b9a-8340-33acd028de08

📥 Commits

Reviewing files that changed from the base of the PR and between aad24bb and 025844c.

📒 Files selected for processing (5)

• apps/developer-docs/docs/.vitepress/config.mts
• apps/docs/docs/.vitepress/config.ts
• packages/theme/README.md
• packages/theme/package.json
• packages/theme/src/seo.ts

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}