Adds intro copy to platform files

franrob-projects · franrob-projects · commit ab0647ce6145 · 2025-12-18T23:50:33.000+01:00
diff --git a/src/pages/docs/platform/account/app/index.mdx b/src/pages/docs/platform/account/app/index.mdx
@@ -1,7 +1,8 @@
 ---
 title: App management overview
-meta_description: " Manage and monitor your applications on the Ably platform using the Ably dashboard. Create new apps, view existing ones, and configure settings from your browser."
-meta_keywords: “Ably dashboard, manage applications, monitor apps, app creation, application settings, Ably platform”
+intro: "App management enables creating, configuring, and monitoring applications through the Ably dashboard. Control application settings, API keys, usage statistics, and notifications from a centralized interface."
+meta_description: "Manage and monitor your applications on the Ably platform using the Ably dashboard. Create new apps, view existing ones, and configure settings from your browser."
+meta_keywords: "Ably dashboard, manage applications, monitor apps, app creation, application settings, Ably platform"
 redirect_from:
   - /docs/account/app
 ---
diff --git a/src/pages/docs/platform/account/control-api.mdx b/src/pages/docs/platform/account/control-api.mdx
@@ -1,5 +1,6 @@
 ---
 title: Programmatic management with Control API
+intro: "The Control API enables programmatic management of Ably accounts, applications, and infrastructure through REST endpoints. This API supports automation, multi-tenancy solutions, and configuration-driven environments for scalable account management."
 meta_description: "The Control API is a REST API that enables you to manage your Ably account programmatically. This is the Control API user guide."
 meta_keywords: "Ably, applications, apps, Control API, account management, control, REST API, OpenAPI Specification, OAS3."
 redirect_from:
diff --git a/src/pages/docs/platform/account/index.mdx b/src/pages/docs/platform/account/index.mdx
@@ -1,6 +1,7 @@
 ---
 title: Account overview
-meta_description: "Manage all aspects of your account, from 2FA and billing to user management and personal preferences. "
+intro: "Account management provides centralized control over authentication, billing, user permissions, and usage monitoring. Access these features through the Ably dashboard to configure security settings, manage team members, and track resource consumption."
+meta_description: "Manage all aspects of your account, from 2FA and billing to user management and personal preferences."
 meta_keywords: "Ably account, 2FA, billing, user management, personal preferences"
 redirect_from:
   - /docs/account
diff --git a/src/pages/docs/platform/architecture/index.mdx b/src/pages/docs/platform/architecture/index.mdx
@@ -1,5 +1,6 @@
 ---
 title: Architecture overview
+intro: "Ably's platform architecture delivers dependable realtime experiences at global scale, serving billions of devices monthly and delivering over half a trillion messages. The globally distributed infrastructure maintains exceptional performance while providing industry-leading quality of service guarantees."
 meta_description: "Learn more about Ably's platform architecture."
 meta_keywords: "architecture"
 ---
diff --git a/src/pages/docs/platform/deprecate/index.mdx b/src/pages/docs/platform/deprecate/index.mdx
@@ -1,5 +1,6 @@
 ---
 title: Deprecation policy
+intro: "Ably's deprecation policy ensures backwards compatibility while enabling feature evolution through semantic versioning guidelines. This policy defines timelines, notification processes, and migration support for SDK and API changes."
 meta_description: "A policy detailing how Ably deprecates SDKs and APIs."
 meta_keywords: "Ably, deprecation policy, deprecation, sunset"
 ---
diff --git a/src/pages/docs/platform/errors/codes.mdx b/src/pages/docs/platform/errors/codes.mdx
@@ -1,5 +1,6 @@
 ---
 title: Error codes
+intro: "Error codes provide specific identifiers with descriptions, causes, and solutions for troubleshooting Ably issues. These standardized codes enable efficient problem resolution across all SDK implementations."
 meta_description: "Understand Ably error codes and their causes, to resolve them efficiently."
 redirect_from:
   - /docs/errors/codes
diff --git a/src/pages/docs/platform/errors/index.mdx b/src/pages/docs/platform/errors/index.mdx
@@ -1,5 +1,6 @@
 ---
 title: Debugging
+intro: "Debugging tools help identify and resolve authentication issues, connection problems, and network disruptions in Ably applications. These include custom log handlers, metachannels for system insights, and the Dev Console for live monitoring."
 meta_description: "Debugging in Ably supported apps, including troubleshooting techniques, logging options, and tools for error analysis."
 redirect_from:
   - /docs/errors/
diff --git a/src/pages/docs/platform/index.mdx b/src/pages/docs/platform/index.mdx
@@ -1,5 +1,6 @@
 ---
 title: About Ably
+intro: "Ably's serverless platform powers realtime digital experiences with globally distributed infrastructure serving billions of devices. The platform ensures data delivery guarantees, enterprise-scale messaging, and consistent low latency worldwide."
 meta_description: "An introduction to Ably and its highly-available, scalable platform."
 ---
 
diff --git a/src/pages/docs/platform/integrations/index.mdx b/src/pages/docs/platform/integrations/index.mdx
@@ -1,5 +1,6 @@
 ---
 title: Integrations overview
+intro: "Integrations connect Ably channels with external services through inbound data ingestion and outbound event streaming. These enable workflows like serverless functions, data pipelines, and message queuing across platforms like AWS, Google Cloud, and Apache Kafka."
 meta_description: "Integrations enable external services to send data to Ably channels, and for Ably events to send their data to external services."
 meta_keywords: "integrations, integration, integrate, stream, external service, webhook, webhooks, functions"
 redirect_from:
diff --git a/src/pages/docs/platform/integrations/streaming/index.mdx b/src/pages/docs/platform/integrations/streaming/index.mdx
@@ -1,5 +1,6 @@
 ---
 title: Outbound streaming overview
+intro: "Outbound streaming integrations enable continuous data flow from Ably channels to external streaming and queuing services. These integrations support realtime processing pipelines with services like Amazon Kinesis, Kafka, and Apache Pulsar."
 meta_description: "Outbound streaming integrations enable you to stream data from Ably to an external service for realtime processing."
 meta_keywords: "realtime streaming, stream processing"
 redirect_from:
diff --git a/src/pages/docs/platform/integrations/webhooks/index.mdx b/src/pages/docs/platform/integrations/webhooks/index.mdx
@@ -1,5 +1,6 @@
 ---
 title: Outbound webhooks overview
+intro: "Outbound webhooks trigger serverless functions and notify HTTP endpoints when messages, presence events, or channel changes occur in Ably. Data can be delivered individually or in batches to external services for processing."
 meta_description: "A guide on webhook payloads, including batched, enveloped, and non-enveloped event payloads, with decoding examples and sources."
 meta_keywords: "webhooks, Ably, payloads, batched events, enveloped events, non-enveloped events, message decoding, presence events, channel lifecycle, data processing"
 redirect_from:
diff --git a/src/pages/docs/platform/pricing/billing.mdx b/src/pages/docs/platform/pricing/billing.mdx
@@ -1,5 +1,6 @@
 ---
 title: Billing
+intro: "Billing calculates monthly costs based on package fees plus actual usage, with invoices issued in arrears on the 1st of each month. Usage minutes are rounded up and charges reflect the previous month's consumption."
 meta_description: "Understand how invoicing and billing works for Ably packages."
 redirect_from:
   - /docs/pricing/billing
diff --git a/src/pages/docs/platform/pricing/index.mdx b/src/pages/docs/platform/pricing/index.mdx
@@ -1,5 +1,6 @@
 ---
 title: Pricing overview
+intro: "Ably offers flexible usage-based pricing with per-minute billing or Monthly Active User models across four package tiers. Each model provides transparent costs for messages, channels, connections, and bandwidth to match your application's needs."
 meta_description: "Understand the pricing models available to you, and understand the benefits of each package type."
 redirect_from:
   - /docs/pricing
diff --git a/src/pages/docs/platform/pricing/limits.mdx b/src/pages/docs/platform/pricing/limits.mdx
@@ -1,5 +1,6 @@
 ---
 title: Limits
+intro: "Limits protect service stability by preventing accidental or deliberate abuse while ensuring cost predictability. These package-based restrictions cover message rates, storage duration, connections, and channels based on your subscription tier."
 meta_description: "The limits associated with each Ably package."
 redirect_from:
   - /docs/general/limits
diff --git a/src/pages/docs/platform/tools/cli.mdx b/src/pages/docs/platform/tools/cli.mdx
@@ -1,5 +1,6 @@
 ---
 title: Ably CLI
+intro: "The Ably CLI manages Ably resources and interacts with product APIs directly from your terminal. This tool enables account management, message publishing/subscribing, and testing with additional client simulations."
 meta_description: "The Ably CLI is a command-line interface for managing Ably resources and interacting with Ably's products APIs directly from your terminal."
 meta_keywords: "Ably CLI, command line, terminal, developer tools"
 ---
