Merge branch 'main' into candlestick-api

Author: dev-dist

.github/scripts/data/baseline.json

@@ -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:**

SEO_METADATA_GUIDE.md

@@ -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",
@@ -106,6 +107,25 @@ export default defineConfig({
   adapter: vercel(),
   vite: {
     plugins: [yaml()],
+    build: {
+      target: "esnext", // Use latest ES features, no transpilation for modern browsers
+      // Optimize CSS delivery
+      cssMinify: true,
+      // Increase the threshold for inlining assets to reduce render-blocking CSS
+      assetsInlineLimit: 20000, // Inline CSS files up to 20KB to eliminate render-blocking
+      // Removed manual chunking to prevent serverless function bloat
+      // rollupOptions: {
+      //   output: {
+      //     manualChunks: ...
+      //   }
+      // },
+    },
+    esbuild: {
+      target: "esnext", // Match build target for consistency
+    },
+    css: {
+      devSourcemap: false,
+    },
   },
   legacy: {
     collections: false,

astro.config.ts

@@ -62,7 +62,7 @@
     "@nanostores/preact": "^0.5.2",
     "@nanostores/react": "^0.8.4",
     "@openzeppelin/contracts": "^4.9.6",
-    "astro": "^5.12.8",
+    "astro": "^5.12.9",
     "bignumber.js": "^9.3.1",
     "clipboard": "^2.0.11",
     "dotenv": "^16.6.1",
@@ -74,7 +74,7 @@
     "lodash": "^4.17.21",
     "marked": "^15.0.12",
     "nanostores": "^0.11.4",
-    "pino": "^9.7.0",
+    "pino": "^9.8.0",
     "preact": "^10.26.9",
     "react-instantsearch": "^7.16.2",
     "rehype-autolink-headings": "^7.1.0",
@@ -98,7 +98,7 @@
     "@rollup/plugin-yaml": "^4.1.2",
     "@types/jest": "^29.5.14",
     "@types/lodash": "^4.17.20",
-    "@types/node": "^20.19.9",
+    "@types/node": "^20.19.10",
     "@types/node-fetch": "^2.6.13",
     "@types/prismjs": "^1.26.5",
     "@types/react": "^19.1.9",
@@ -114,7 +114,7 @@
     "eslint-plugin-n": "^15.7.0",
     "eslint-plugin-prettier": "^5.5.0",
     "eslint-plugin-promise": "^6.1.1",
-    "hardhat": "^2.26.1",
+    "hardhat": "^2.26.2",
     "husky": "^9.1.7",
     "jest-yaml-transform": "^0.2.0",
     "lint-staged": "^15.5.2",