docs(seo): hub structured-data + social + self-hosted assets parity#653
Open
rain-Brian wants to merge 3 commits into
Open
docs(seo): hub structured-data + social + self-hosted assets parity#653rain-Brian wants to merge 3 commits into
rain-Brian wants to merge 3 commits into
Conversation
Brings the Biodiversity hub to the MegaDetector docs gold standard (infra layer): - Add overrides/main.html: Organization JSON-LD + an ItemList of the cluster's four documentation sites (the entity anchor tying the cluster together for search), BreadcrumbList on interior pages, and a clean homepage <title>. - Add Open Graph + Twitter Card meta with a local share image. - Self-host favicon/logo and the homepage banner in docs/assets/ (drop the cross-origin Zenodo requests on render-blocking assets). - Fix site_description and the homepage description: they described PyTorch-Wildlife and carried the deprecated "SPARROW Studio" name; they now describe the hub and target its umbrella keywords. - Add mkdocs-callouts and git-revision-date-localized plugins (+ deps) and set fetch-depth: 0 in the docs deploy workflow so last-updated dates render. Part of the cluster SEO-parity work (ADO Epic 506340).
Per external schema review: model the homepage as WebSite + CollectionPage (the page's main entity is the project collection, not the Lab) + Organization (the Lab as publisher) + ItemList of the four sub-sites, cross-linked by @id. Add sameAs (GitHub) and og:image:alt. Banner swap to a 1200x630 image is a tracked design dependency.
…; omit private Acoustic from ItemList
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.
What
Brings the Biodiversity hub to the MegaDetector docs gold standard at the infrastructure / structured-data layer (first of two hub PRs; the content/cohesion PR follows).
Changes
overrides/main.htmlwith Organization JSON-LD (the AI for Good Lab Biodiversity initiative) + an ItemList of the cluster's four documentation sites (the entity anchor that ties the cluster together for search), BreadcrumbList on interior pages, and a clean homepage<title>. Both JSON-LD blocks validated as well-formed.docs/assets/(drops cross-origin Zenodo requests on render-blocking assets).site_descriptionand the homepage description described PyTorch-Wildlife and carried the deprecated "SPARROW Studio" name; both now describe the hub and target its umbrella keywords (Microsoft biodiversity AI,open source conservation AI).mkdocs-callouts+git-revision-date-localizedplugins (+ deps) andfetch-depth: 0in the deploy workflow so last-updated dates render.Verification
mkdocs buildsucceeds; homepage emits 2 valid JSON-LD blocks (Organization + ItemList×4), OG/Twitter tags with absolute image URL, interior BreadcrumbList, and last-updated dates render.--strictis not used as a gate here because the repo's baseline already trips 2 pre-existing griffe/mkdocstrings docstring warnings inPytorchWildlifesource, unrelated to this change.Scope notes