feat(seo): inject brand-level Organization JSON-LD with sameAs linking docs to the Celo entity - #2285
Open
GigaHierz wants to merge 1 commit into
Open
feat(seo): inject brand-level Organization JSON-LD with sameAs linking docs to the Celo entity#2285GigaHierz wants to merge 1 commit into
GigaHierz wants to merge 1 commit into
Conversation
…g docs to the Celo entity Closes #2283 Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
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.
The hole, and the fix
Verified live today: Mintlify auto-injects an
Organizationschema named "Celo Docs" with nosameAs, plus aWebSitenode crediting Mintlify as creator — the docs are disconnected from the Celo brand entity that search and AI engines resolve.Adds
seo-schema.js(Mintlify loads any content-directory.json every page, no wiring needed) injecting one JSON-LD@graph: anOrganizationCelo (https://celo.org/#organization) with asameAsarray (GitHub org, X, YouTube, Discord, Forum, CoinGecko, DefiLlama, L2BEAT), and aWebSitenode for docs.celo.org whosepublisherpoints at that Organization — the docs→brand linkage the entity graph was missing.What this does NOT do / residual risk
@ids (celo.org/#organization,docs.celo.org/#celo-docs) differ from Mintlify's (docs.celo.org/#organization,docs.celo.org#website).Judgement calls
sameAslist = the docs.json footer socials + the three data aggregators the entity graph needs (CoinGecko, DefiLlama, L2BEAT). Adding/removing an entry is a one-line change.Issues
Refs #2283 — closes the script box; the "verified on the preview deployment" box stays open until the Mintlify preview for this PR is up (checkbox below).
Stacking / conflicts
Branched off
main, independent — new file only.Verification evidence
Every
sameAsURL verified: five return 200 to curl; CoinGecko and DefiLlama return 403 to curl (Cloudflare bot-blocking) but their APIs confirm the slugs (api.coingecko.com/api/v3/coins/celo→ idcelo;api.llama.fi/v2/chainslists Celo); L2BEAT project page returns 200.Remaining ops steps
JSON.parse(document.querySelectorAll('script[type="application/ld+json"]')[last].text)in the console (or Google's Rich Results test) and tick this boxChecklist
main