redirect leading slahes (#2881)

Author: aelmanaa

SEO_METADATA_GUIDE.md

@@ -61,9 +61,9 @@ Every page automatically receives:
 ```html
 <title>Page Title | Chainlink Documentation</title>
 <meta name="description" content="..." />
-<meta name="keywords" content="..." />
 <link rel="canonical" href="..." />
 <meta property="og:title" content="..." />
+<meta property="og:type" content="article" />
 <meta property="og:description" content="..." />
 <meta name="twitter:card" content="summary_large_image" />
 ```
@@ -78,12 +78,26 @@ Every page automatically receives:
     "name": "Deploy Your First Smart Contract",
     "description": "Learn to deploy smart contracts in 10 minutes",
     "totalTime": "PT10M",
-    "author": { "@type": "Organization", "name": "Chainlink" },
-    "publisher": { "@type": "Organization", "name": "Chainlink" }
+    "author": { "@type": "Organization", "name": "Chainlink Labs" },
+    "publisher": { "@type": "Organization", "name": "Chainlink Documentation" }
   }
 </script>
 ```
 
+### Canonical URLs
+
+- Non-versioned pages can override canonical with `metadata.canonical`.
+  - Relative values are resolved to absolute URLs using the site base.
+- Versioned API reference pages set canonicals/alternates via the version head component.
+  - Latest version: `rel="canonical"`; other versions: `rel="alternate"`.
+  - `hreflang` is not used for versioning.
+
+### Open Graph Type
+
+- `og:type` is set contextually:
+  - `website`: for `/`, `/ccip`, `/ccip/directory*`, `/data-feeds`, `/vrf`, `/chainlink-functions`, `/chainlink-automation`, `/chainlink-local`, `/resources`.
+  - `article`: for all other pages.
+
 ## Content Types & Templates
 
 ### Quickstarts
@@ -157,7 +171,7 @@ metadata:
 **Generated Schema**: TechArticle + LearningResource
 
 - `educationalLevel`: From `difficulty` field
-- `teaches`: Auto-generated from content analysis
+- `teaches`: Derived from content type and product (e.g., "Concept for CCIP")
 - `learningResourceType`: "Concept"
 
 ### Guides
@@ -317,15 +331,20 @@ excerpt: "ccip cross-chain token transfer tutorial hardhat solidity intermediate
 
 ### Image Guidelines
 
-**Path Format**: `/images/[product]/[descriptive-name].png`
+**Path Format**:
+
+- Standard pages: `metadata.image` should be an absolute path like `/images/[product]/[descriptive-name].png`.
+- Quickstarts: `frontmatter.image` is a filename resolved to `/images/quickstarts/feature/{filename}`.
 
 **Requirements:**
 
 - Minimum 1200x630px for social sharing
-- Use WebP format when possible
+- Prefer PNG or JPG for broad preview compatibility
+- WebP is acceptable, but some bots preview PNG/JPG more reliably
+- Avoid animated GIFs for social previews (often heavy; many platforms show only the first frame)
 - Include alt text context in filename
 
-**Note**: Images are optional - the system automatically falls back to the Chainlink logo for social sharing if no custom image is provided.
+**Note**: The system falls back to the Chainlink logo if no custom image is provided. The current implementation sets `og:image:type` to `image/png`; using PNG avoids type mismatches.
 
 ### Content Hierarchy
 
@@ -339,21 +358,6 @@ excerpt: "ccip cross-chain token transfer tutorial hardhat solidity intermediate
 
 ## Validation & Testing
 
-### Build-Time Validation
-
-Run the validation script to check structured data compliance:
-
-```bash
-npm run validate-structured-data
-```
-
-This script validates:
-
-- Required Schema.org properties
-- ISO 8601 duration formats
-- URL validity
-- Content type classification
-
 ### Manual Testing Tools
 
 **Google Rich Results Test:**
@@ -449,8 +453,8 @@ Run `npm run build` and check for errors in console.
 **Reality**: Minimal impact
 
 - JSON-LD scripts are small (typically <2KB)
-- Processed at build time, not runtime
-- No additional HTTP requests
+- Processed at build time (no client-side runtime cost)
+- Social image existence is validated at build time; no client-side requests
 - Automatic fallbacks prevent missing data
 
 ---
@@ -477,12 +481,6 @@ When updating existing content for better SEO:
 - [ ] Add `metadata.lastModified` when updating content
 - [ ] Add `metadata.version` for API references
 
-### Validation
-
-- [ ] Test with validation script: `npm run validate-structured-data`
-- [ ] Check Rich Results Test
-- [ ] Verify social sharing preview
-
 ## Current Implementation Status
 
 **✅ Fully Implemented Features:**

astro.config.ts

@@ -28,6 +28,7 @@ const redirectSources = new Set(
 // https://astro.build/config
 export default defineConfig({
   site: "https://docs.chain.link",
+  trailingSlash: "never",
   redirects: {
     "/ccip/directory": "/ccip/directory/mainnet",
     "/ccip/supported-networks": "/ccip/directory/mainnet",

public/images/ccip/detailed-architecture.png

@@ -16,6 +16,7 @@ import { getTokenIconUrl } from "~/features/utils"
 import ChainTokenGrid from "./ChainTokenGrid"
 import { generateChainStructuredData } from "~/utils/ccipStructuredData"
 import StructuredData from "~/components/StructuredData.astro"
+import { DOCS_BASE_URL } from "~/utils/structuredData"
 
 interface Props {
   environment: Environment
@@ -49,21 +50,32 @@ const searchLanes = getSearchLanes({ environment })
 
 // Generate dynamic metadata for this specific chain
 const environmentText = environment === Environment.Mainnet ? "Mainnet" : "Testnet"
+const logoPath = network.logo || ""
+const logoPathname = (() => {
+  try {
+    return new URL(logoPath, Astro.site).pathname.toLowerCase()
+  } catch {
+    return logoPath.toLowerCase()
+  }
+})()
+const socialImage = logoPathname.endsWith(".svg") ? "/files/ccip-directory.jpg" : logoPath
+
 const chainMetadata = {
   title: `${network.name} CCIP Network - ${environmentText} Cross-Chain Configuration`,
   description: `CCIP configuration for ${network.name} on ${environmentText}. View ${allTokens.length > 0 ? `${allTokens.length} supported tokens` : "supported tokens"}, active cross-chain lanes, fees, and technical specifications.`,
-  image: network.logo,
+  image: socialImage,
   excerpt: `${network.name} CCIP network configuration ${environmentText.toLowerCase()} cross-chain interoperability ${network.chainType.toLowerCase()} supported tokens lanes fees technical specifications`,
 }
 
-// Generate structured data for this chain
-const currentURL = new URL(Astro.request.url).href
+// Generate structured data for this chain (use production base for JSON-LD URLs)
+const currentPath = new URL(Astro.request.url).pathname
+const canonicalForJsonLd = `${DOCS_BASE_URL}${currentPath}`
 const chainStructuredData = generateChainStructuredData(
   network,
   environment,
   allTokens.length,
   lanes.length,
-  currentURL
+  canonicalForJsonLd
 )
 ---
 
@@ -79,8 +91,15 @@ const chainStructuredData = generateChainStructuredData(
   }}
   {headings}
   environment={environment}
+  structuredData={chainStructuredData}
+  pageTitleOverride={chainMetadata.title}
+  metadataOverride={{
+    description: chainMetadata.description,
+    image: chainMetadata.image,
+    excerpt: chainMetadata.excerpt,
+  }}
+  suppressDefaultStructuredData={true}
 >
-  <StructuredData data={chainStructuredData} />
   <ChainHero
     chains={networks}
     tokens={allTokens}

src/components/CCIP/Chain/Chain.astro

@@ -13,6 +13,9 @@ import {
 import { getTokenIconUrl } from "~/features/utils"
 import NetworkGrid from "./NetworkGrid"
 import TokenGrid from "../TokenGrid/TokenGrid"
+import StructuredData from "~/components/StructuredData.astro"
+import { generateDirectoryStructuredData } from "~/utils/ccipStructuredData"
+import { DOCS_BASE_URL } from "~/utils/structuredData"
 
 export type Props = {
   environment: Environment
@@ -41,9 +44,27 @@ const allTokens = tokens.map((token) => {
   }
 })
 const searchLanes = getSearchLanes({ environment })
+
+// Generate directory-level structured data (DataCatalog/Dataset)
+// Use production base for canonical JSON-LD URLs (avoid local IPv6/port)
+const currentPath = new URL(Astro.request.url).pathname
+const canonicalForJsonLd = `${DOCS_BASE_URL}${currentPath}`
+const directoryStructuredData = generateDirectoryStructuredData(environment, networks, tokens, canonicalForJsonLd)
 ---
 
-<CcipDirectoryLayout frontmatter={entry.data} {headings} environment={environment}>
+<CcipDirectoryLayout
+  frontmatter={entry.data}
+  {headings}
+  environment={environment}
+  structuredData={directoryStructuredData}
+  pageTitleOverride={`CCIP Directory - ${environment === Environment.Mainnet ? "Mainnet" : "Testnet"}`}
+  metadataOverride={{
+    ...(entry.data.metadata || {}),
+    description: `Explore CCIP Directory for ${environment === Environment.Mainnet ? "Mainnet" : "Testnet"}: configuration data for supported blockchains and tokens, cross-chain lanes, contract addresses, rate limits, and operational status on ${environment === Environment.Mainnet ? "Mainnet" : "Testnet"}.`,
+    image: "/files/ccip-directory.jpg",
+  }}
+  suppressDefaultStructuredData={true}
+>
   <Hero chains={networks} tokens={allTokens} environment={environment} client:load lanes={searchLanes} />
   <section class="layout">
     <div>

src/components/CCIP/Landing/ccip-landing.astro

@@ -24,6 +24,7 @@ import {
 import Drawer from "~/components/CCIP/Drawer/Drawer"
 import { generateTokenStructuredData } from "~/utils/ccipStructuredData"
 import StructuredData from "~/components/StructuredData.astro"
+import { DOCS_BASE_URL } from "~/utils/structuredData"
 
 interface Props {
   token: string
@@ -84,8 +85,10 @@ const tokenMetadata = {
   excerpt: `${token} cross-chain token CCIP ${environmentText.toLowerCase()} supported networks pool types rate limits transfer mechanisms blockchain interoperability`,
 }
 
-// Generate structured data for this token page
-const tokenStructuredData = generateTokenStructuredData(token, environment, chainsOfToken.length, Astro.url.href)
+// Generate structured data for this token page (use production base for JSON-LD URLs)
+const currentPath = new URL(Astro.request.url).pathname
+const canonicalForJsonLd = `${DOCS_BASE_URL}${currentPath}`
+const tokenStructuredData = generateTokenStructuredData(token, environment, chainsOfToken.length, canonicalForJsonLd)
 ---
 
 <CcipDirectoryLayout
@@ -100,6 +103,14 @@ const tokenStructuredData = generateTokenStructuredData(token, environment, chai
   }}
   {headings}
   environment={environment}
+  structuredData={tokenStructuredData}
+  pageTitleOverride={tokenMetadata.title}
+  metadataOverride={{
+    description: tokenMetadata.description,
+    image: tokenMetadata.image,
+    excerpt: tokenMetadata.excerpt,
+  }}
+  suppressDefaultStructuredData={true}
 >
   <ChainHero
     chains={networks}
@@ -158,8 +169,6 @@ const tokenStructuredData = generateTokenStructuredData(token, environment, chai
   </section>
 </CcipDirectoryLayout>
 
-<StructuredData data={tokenStructuredData} />
-
 <style scoped="false">
   .layout {
     --doc-padding: var(--space-6x);