Add description frontmatter to major pages

clavery · clavery · commit 617132a3baa1 · 2026-01-14T20:34:58.000-05:00
diff --git a/docs/api-readme.md b/docs/api-readme.md
@@ -1,3 +1,7 @@
+---
+description: API reference for the B2C Tooling SDK with typed WebDAV and OCAPI clients for programmatic B2C Commerce operations.
+---
+
 # API Reference
 
 The `@salesforce/b2c-tooling-sdk` package provides a programmatic API for interacting with Salesforce B2C Commerce instances.
diff --git a/docs/cli/auth.md b/docs/cli/auth.md
@@ -1,3 +1,7 @@
+---
+description: Authentication commands for obtaining OAuth tokens and configuring Account Manager API clients, OCAPI, and WebDAV access.
+---
+
 # Auth Commands
 
 Commands for authentication and token management.
diff --git a/docs/cli/code.md b/docs/cli/code.md
@@ -1,3 +1,7 @@
+---
+description: Commands for deploying cartridges, activating code versions, and watching for file changes on B2C Commerce instances.
+---
+
 # Code Commands
 
 Commands for managing cartridge code on B2C Commerce instances.
diff --git a/docs/cli/custom-apis.md b/docs/cli/custom-apis.md
@@ -1,3 +1,7 @@
+---
+description: Commands for managing SCAPI Custom API endpoints, checking registration status, and debugging endpoint configurations.
+---
+
 # Custom APIs
 
 Commands for managing SCAPI Custom API endpoints.
diff --git a/docs/cli/index.md b/docs/cli/index.md
@@ -1,3 +1,7 @@
+---
+description: B2C CLI command reference with global flags and authentication options for managing Salesforce Commerce Cloud instances.
+---
+
 # CLI Reference
 
 The `b2c` CLI provides commands for managing Salesforce B2C Commerce instances.
diff --git a/docs/cli/jobs.md b/docs/cli/jobs.md
@@ -1,3 +1,7 @@
+---
+description: Commands for executing jobs, importing and exporting site archives, and monitoring job execution status.
+---
+
 # Job Commands
 
 Commands for executing and monitoring jobs on B2C Commerce instances.
diff --git a/docs/cli/logging.md b/docs/cli/logging.md
@@ -1,3 +1,7 @@
+---
+description: Configure CLI logging with log levels, JSON output for CI/CD, and environment variables for debugging.
+---
+
 # Logging
 
 The CLI uses [pino](https://github.com/pinojs/pino) for structured logging with pretty-printed output by default.
diff --git a/docs/cli/mrt.md b/docs/cli/mrt.md
@@ -1,3 +1,7 @@
+---
+description: Commands for managing Managed Runtime projects, pushing bundles, creating environments, and configuring environment variables.
+---
+
 # MRT Commands
 
 Commands for managing Managed Runtime (MRT) projects, environments, and bundles.
diff --git a/docs/cli/ods.md b/docs/cli/ods.md
@@ -1,3 +1,7 @@
+---
+description: Commands for creating, managing, starting, stopping, and deleting On-Demand Sandboxes (ODS) for development.
+---
+
 # ODS Commands
 
 Commands for managing On-Demand Sandboxes (ODS).
diff --git a/docs/cli/sites.md b/docs/cli/sites.md
@@ -1,3 +1,7 @@
+---
+description: Commands for listing and managing storefront sites on B2C Commerce instances.
+---
+
 # Sites Commands
 
 Commands for managing sites on B2C Commerce instances.
diff --git a/docs/cli/slas.md b/docs/cli/slas.md
@@ -1,3 +1,7 @@
+---
+description: Commands for creating, updating, and managing Shopper Login and API Access Service (SLAS) clients.
+---
+
 # SLAS Commands
 
 Commands for managing Shopper Login and API Security (SLAS) clients.
diff --git a/docs/cli/webdav.md b/docs/cli/webdav.md
@@ -1,3 +1,7 @@
+---
+description: Commands for WebDAV file operations including listing, uploading, downloading, and managing files on B2C Commerce instances.
+---
+
 # WebDAV Commands
 
 Commands for file operations on B2C Commerce instance WebDAV.
diff --git a/docs/guide/agent-skills.md b/docs/guide/agent-skills.md
@@ -1,3 +1,7 @@
+---
+description: AI agent skills and plugins for Claude Code, Cursor, and GitHub Copilot that enhance B2C Commerce development.
+---
+
 # Agent Skills & Plugins
 
 The B2C Developer Tooling project provides agent skills that enhance the AI-assisted development experience when working with Salesforce B2C Commerce projects.
diff --git a/docs/guide/authentication.md b/docs/guide/authentication.md
@@ -1,3 +1,7 @@
+---
+description: Set up authentication for the B2C CLI including Account Manager API clients, OCAPI permissions, and WebDAV access keys.
+---
+
 # Authentication Setup
 
 This guide covers setting up authentication for the B2C CLI, including Account Manager API clients, OCAPI permissions, and WebDAV access.
diff --git a/docs/guide/configuration.md b/docs/guide/configuration.md
@@ -1,3 +1,7 @@
+---
+description: Configure the B2C CLI with environment variables, dw.json files, and multi-instance setups for different environments.
+---
+
 # Configuration
 
 The B2C CLI automatically detects and uses available credentials. You can provide credentials via CLI flags, environment variables, or configuration files.
diff --git a/docs/guide/extending.md b/docs/guide/extending.md
@@ -1,3 +1,7 @@
+---
+description: Extend the B2C CLI with custom plugins, configuration sources, HTTP middleware, and lifecycle hooks.
+---
+
 # Extending the CLI
 
 The B2C CLI can be extended with custom plugins using the [oclif plugin system](https://oclif.io/docs/plugins). Plugins can add new commands, provide custom configuration sources, and integrate with external systems.
diff --git a/docs/guide/index.md b/docs/guide/index.md
@@ -1,3 +1,7 @@
+---
+description: Introduction to the B2C CLI and SDK for Salesforce Commerce Cloud B2C code deployment, site management, and sandbox operations.
+---
+
 # Introduction
 
 The B2C CLI is a command-line interface for Salesforce Commerce Cloud B2C. It provides tools for:
diff --git a/docs/guide/installation.md b/docs/guide/installation.md
@@ -1,3 +1,7 @@
+---
+description: Install the B2C CLI via Homebrew, npm, or GitHub releases, and optionally install the SDK for programmatic use.
+---
+
 # Installation
 
 ## Prerequisites
diff --git a/docs/guide/security.md b/docs/guide/security.md
@@ -1,3 +1,7 @@
+---
+description: Security practices for the B2C Developer Tooling project including supply chain protections and dependency management.
+---
+
 # Security
 
 This page covers security practices used in the B2C Developer Tooling project, with a focus on supply chain security.
diff --git a/docs/guide/third-party-plugins.md b/docs/guide/third-party-plugins.md
@@ -1,3 +1,7 @@
+---
+description: Community plugins for the B2C CLI including IntelliJ SFCC config integration and macOS Keychain credential storage.
+---
+
 # 3rd Party Plugins
 
 The B2C CLI can be extended with community-developed plugins that add new functionality or integrate with external tools.
diff --git a/docs/index.md b/docs/index.md
@@ -1,4 +1,5 @@
 ---
+description: Command line tools and SDK for Salesforce Commerce Cloud B2C - deploy code, manage sandboxes, run jobs, and automate operations.
 layout: home
 
 hero:
