Docs: Add social description to a bunch of pages

duncanmcclean · duncanmcclean · commit 8314b3014d36 · 2025-08-18T19:17:23.000+01:00
We don't need a description on every page, just where people are likely to share in a work chat/discord.
diff --git a/docs/docs/carts.md b/docs/docs/carts.md
@@ -1,5 +1,6 @@
 ---
 title: Carts
+description: "Cargo revolves around two main concepts: carts and orders. This page explains the differences between them, how to add products to a cart, and how to store carts."
 ---
 ## Overview
 Cargo revolves around two main concepts: carts and orders.
diff --git a/docs/docs/customers.md b/docs/docs/customers.md
@@ -1,5 +1,6 @@
 ---
 title: Customers
+description: Carts and Orders are associated with customers - representing the customer who purchased something from your store.
 ---
 
 Carts and orders are associated with customers - representing the customer who purchased something from your store.
diff --git a/docs/docs/discounts.md b/docs/docs/discounts.md
@@ -1,5 +1,6 @@
 ---
 title: Discounts
+description: "Discounts are simply reductions to a cart's grand total, calculated using a set of user-defined rules. Cargo supports site-wide and code-based discounts."
 ---
 
 Discounts are simply reductions to a cart's grand total, calculated using a set of user-defined rules.
diff --git a/docs/docs/email-notifications.md b/docs/docs/email-notifications.md
@@ -1,5 +1,6 @@
 ---
 title: Email Notifications
+description: "Cargo can send email notifications to customers when they place an order. This page explains how to configure Cargo to send emails, and how to preview them in the browser."
 ---
 
 When you install Cargo, it will automatically create a [mailable](https://laravel.com/docs/master/mail) for you, resulting in a class in `app/Mail` and a view in `resources/views/emails`.
diff --git a/docs/docs/help.md b/docs/docs/help.md
@@ -1,5 +1,6 @@
 ---
 title: Help
+description: "If you're having trouble with Cargo, please reach out for help. This page explains how to submit a bug report, feature request, or get general support."
 ---
 
 If you're having trouble with Cargo, please reach out for help.
diff --git a/docs/docs/installation.md b/docs/docs/installation.md
@@ -1,5 +1,6 @@
 ---
 title: Installation
+description: "Cargo is a comprehensive e-commerce addon for Statamic. This page explains how to install Cargo, including prerequisites and next steps."
 ---
 
 ## Prerequisites
diff --git a/docs/docs/migrating-from-simple-commerce.md b/docs/docs/migrating-from-simple-commerce.md
@@ -1,5 +1,6 @@
 ---
 title: Migration from Simple Commerce
+description: "Cargo is the natural evolution of Simple Commerce. This page explains how to migrate from Simple Commerce to Cargo, including installation, configuration, and code changes."
 ---
 :::tip info
 This migration guide is still a work in progress - there's bound to be things missing. If you come across something which hasn't been covered here, please [open an issue](https://github.com/duncanmcclean/cargo/issues/new) or a [pull request](https://github.com/duncanmcclean/statamic-cargo/pulls).
diff --git a/docs/docs/multi-site.md b/docs/docs/multi-site.md
@@ -1,8 +1,9 @@
 ---
 title: Multi-site
+description: "Cargo supports Statamic's multi-site feature, enabling you to sell goods internationally in different currencies or use the same Statamic instance to power multiple brands."
 ---
 
-Cargo supports Statamic's [multi-site](https://statamic.dev/multi-site) feature, enabling you to sell goods internationally in different currencies, or use the same Statamic instance to power multiple brands.
+Cargo supports Statamic's [multi-site](https://statamic.dev/multi-site) feature, enabling you to sell goods internationally in different currencies or use the same Statamic instance to power multiple brands.
 
 Carts and Orders are separate for each site - and can be viewed separately in the Control Panel.
 
diff --git a/docs/docs/orders.md b/docs/docs/orders.md
@@ -1,5 +1,6 @@
 ---
 title: Orders
+description: "Orders are created at the end of the Checkout process, just before the payment is confirmed. This page explains how to manage orders, including blueprints, statuses, and storage options."
 ---
 Orders are created at the end of the [Checkout](/frontend/checkout/introduction) process, just before the payment is confirmed.
 
diff --git a/docs/docs/payment-gateways.md b/docs/docs/payment-gateways.md
@@ -1,5 +1,6 @@
 ---
 title: Payment Gateways
+description: "Cargo supports multiple payment gateways, including Stripe, Mollie, and a Dummy gateway for testing. This page explains how to configure and use these gateways."
 ---
 
 ## Configuration
diff --git a/docs/docs/products.md b/docs/docs/products.md
@@ -1,5 +1,6 @@
 ---
 title: Products
+description: "Cargo's products are just entries, with a few extra fields. This page explains how to set up products, including digital products, inventory tracking, and product variants."
 ---
 
 Products are just entries, with a few additional fields (Price / Type / Tax Class). 
diff --git a/docs/docs/shipping.md b/docs/docs/shipping.md
@@ -1,5 +1,6 @@
 ---
 title: Shipping
+description: "Cargo allows you to define shipping methods and options, which can be selected by customers during checkout. This page explains how to create and configure shipping methods."
 ---
 
 When you're selling physical products, you need a way to ship those products out to your customers.
diff --git a/docs/docs/static-caching.md b/docs/docs/static-caching.md
@@ -1,5 +1,6 @@
 ---
 title: Static Caching
+description: "Static Caching is a must-have for Statamic sites. This page explains how to configure static caching with Cargo, including dynamic content and cart/checkout pages."
 ---
 
 Static Caching is a must-have for Statamic sites. It helps to make your website blazing fast, which is important for e-commerce sites, where every second counts.
diff --git a/docs/docs/taxes.md b/docs/docs/taxes.md
@@ -1,5 +1,6 @@
 ---
 title: Taxes
+description: "Cargo supports tax classes and tax zones, allowing you to configure how taxes are applied to products and shipping costs."
 ---
 
 No one likes taxes, but we have to deal with them anyway. Cargo represents taxes using tax classes and tax zones, all configurable in the Control Panel.
diff --git a/docs/frontend/checkout/custom.md b/docs/frontend/checkout/custom.md
@@ -1,7 +1,8 @@
 ---
 title: Custom checkout flow
+description: "Learn how to build a custom checkout flow using Cargo's Antlers tags and JSON API endpoints."
 ---
-We recommend splitting your checkout flow into multiple steps, to allow for totals to be recalculated when the customer's cart is updated.
+We recommend splitting your checkout flow into multiple steps to allow for totals to be recalculated when the customer's cart is updated.
 
 Most stores split their checkout flow into the following steps:
 * Customer information
diff --git a/docs/frontend/checkout/introduction.md b/docs/frontend/checkout/introduction.md
@@ -1,5 +1,6 @@
 ---
 title: "Checkout: Introduction"
+description: "Cargo's checkout flow is designed to be flexible and easy to use, with both pre-built and custom options available."
 ---
 It's all well and good having a website listing your products, but if your customers can't actually buy anything, then what's the point?
 
diff --git a/docs/frontend/checkout/prebuilt.md b/docs/frontend/checkout/prebuilt.md
@@ -1,8 +1,9 @@
 ---
 title: Pre-built checkout flow
+description: "Cargo comes with a pre-built checkout flow, which you can publish and customise to suit your needs. This page explains how to install and use the pre-built checkout flow."
 ---
 ## Publishing
-You may have published the pre-built checkout flow during the install process, if so you can skip this step.
+You may have published the pre-built checkout flow during the install process, if so, you can skip this step.
 
 To publish the pre-built checkout flow into your project, run this command:
 
diff --git a/docs/frontend/tags/cart.md b/docs/frontend/tags/cart.md
@@ -1,5 +1,6 @@
 ---
 title: Cart Tag
+description: "The {{ cart }} tag allows you to add products to the customer's cart, get cart totals and loop through line items."
 ---
 
 You can use the `{{ cart }}` tag to do just about anything related the customer's cart, including getting cart totals and looping through line items.
diff --git a/docs/frontend/tags/orders.md b/docs/frontend/tags/orders.md
@@ -1,5 +1,6 @@
 ---
 title: Orders Tag
+description: "The `{{ orders }}` tag allows you to loop through your orders on the frontend. Useful for display a customer's order history."
 ---
 
 The `{{ orders }}` tag allows you to loop through your orders on the frontend. Useful for display a customer's order history.
