From eae7e4e0532c76efcae3bbd62c5d12078293682f Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?M=C3=A9gane=20Lacheny?= Date: Thu, 28 Aug 2025 15:50:23 +0200 Subject: [PATCH] Add TL;DR in quote at the beginning of each Cloud docs page --- docusaurus/docs/cloud/account/account-billing.md | 5 ++++- docusaurus/docs/cloud/account/account-settings.md | 3 +++ docusaurus/docs/cloud/advanced/database.md | 3 +++ docusaurus/docs/cloud/advanced/email.md | 3 +++ docusaurus/docs/cloud/advanced/upload.md | 3 +++ docusaurus/docs/cloud/cli/cloud-cli.md | 5 ++++- docusaurus/docs/cloud/getting-started/caching.md | 3 +++ docusaurus/docs/cloud/projects/collaboration.md | 2 ++ docusaurus/docs/cloud/projects/deploys-history.md | 3 +++ docusaurus/docs/cloud/projects/deploys.md | 3 +++ docusaurus/docs/cloud/projects/notifications.md | 3 +++ docusaurus/docs/cloud/projects/overview.md | 3 +++ docusaurus/docs/cloud/projects/runtime-logs.md | 3 +++ docusaurus/docs/cloud/projects/settings.md | 3 +++ 14 files changed, 43 insertions(+), 2 deletions(-) diff --git a/docusaurus/docs/cloud/account/account-billing.md b/docusaurus/docs/cloud/account/account-billing.md index 0a566ef62a..d3cfe16588 100644 --- a/docusaurus/docs/cloud/account/account-billing.md +++ b/docusaurus/docs/cloud/account/account-billing.md @@ -14,7 +14,10 @@ tags: import InvoiceStatus from '/docs/snippets/invoices-statuses.md' -# Account billing & invoices +# Account billing & invoices + +> Billing details and invoices are managed on the Profile page, where payment methods are updated and invoice history is available. +
Through the *Profile* page, accessible by clicking on your profile picture on the top right hand corner of the interface then clicking on **Profile**, you can access the [ *Billing*](#account-billing) and [ *Invoices*](#account-invoices) tabs. diff --git a/docusaurus/docs/cloud/account/account-settings.md b/docusaurus/docs/cloud/account/account-settings.md index 952476bf01..3c77c1d52d 100644 --- a/docusaurus/docs/cloud/account/account-settings.md +++ b/docusaurus/docs/cloud/account/account-settings.md @@ -15,6 +15,9 @@ pagination_next: cloud/account/account-billing # Profile settings +> Settings of the Profile page include account details, connected accounts, and account deletion options. +
+ The *Profile* page enables you to manage your account details and preferences. It is accessible by clicking on your profile picture, on the top right hand corner of the interface, and **Profile**. There are 3 tabs available in the *Profile* interface: [*General*](#general), *Billing* and Invoices (the last 2 are documented in the [Account billing details](/cloud/account/account-billing) section of this documentation). diff --git a/docusaurus/docs/cloud/advanced/database.md b/docusaurus/docs/cloud/advanced/database.md index 4a117f7b44..2e97668698 100644 --- a/docusaurus/docs/cloud/advanced/database.md +++ b/docusaurus/docs/cloud/advanced/database.md @@ -15,6 +15,9 @@ pagination_next: cloud/advanced/email # Database +> Default PostgreSQL can be swapped for any supported SQL database by aligning configuration and environment variables. +
+ Strapi Cloud provides a pre-configured PostgreSQL database by default. However, you can also configure it to utilize an external SQL database, if needed. :::prerequisites diff --git a/docusaurus/docs/cloud/advanced/email.md b/docusaurus/docs/cloud/advanced/email.md index 7dfedb21ce..cd96f76ef8 100644 --- a/docusaurus/docs/cloud/advanced/email.md +++ b/docusaurus/docs/cloud/advanced/email.md @@ -14,6 +14,9 @@ tags: # Email Provider +> Third‑party email services integrate through plugins and environment variables to replace the default sender. +
+ Strapi Cloud comes with a basic email provider out of the box. However, it can also be configured to utilize another email provider, if needed. :::caution diff --git a/docusaurus/docs/cloud/advanced/upload.md b/docusaurus/docs/cloud/advanced/upload.md index cf6490fbdb..d693463ff0 100644 --- a/docusaurus/docs/cloud/advanced/upload.md +++ b/docusaurus/docs/cloud/advanced/upload.md @@ -16,6 +16,9 @@ tags: # Upload Provider +> External storage like S3 or Cloudinary requires plugin setup, security middleware, and Cloud variables. +
+ Strapi Cloud comes with a local upload provider out of the box. However, it can also be configured to utilize a third-party upload provider, if needed. :::caution diff --git a/docusaurus/docs/cloud/cli/cloud-cli.md b/docusaurus/docs/cloud/cli/cloud-cli.md index 42154ae6e7..28d9c559c5 100644 --- a/docusaurus/docs/cloud/cli/cloud-cli.md +++ b/docusaurus/docs/cloud/cli/cloud-cli.md @@ -9,7 +9,10 @@ tags: pagination_next: cloud/advanced/database --- -# Command Line Interface (CLI) +# Command Line Interface (CLI) + +> CLI commands handle login, project deploy, linking, listing, and logout without needing a remote repository. +
Strapi Cloud comes with a Command Line Interface (CLI) which allows you to log in and out, and to deploy a local project without it having to be hosted on a remote git repository. The CLI works with both the `yarn` and `npm` package managers. diff --git a/docusaurus/docs/cloud/getting-started/caching.md b/docusaurus/docs/cloud/getting-started/caching.md index 787d512b4a..8bcc8b7be3 100644 --- a/docusaurus/docs/cloud/getting-started/caching.md +++ b/docusaurus/docs/cloud/getting-started/caching.md @@ -10,6 +10,9 @@ tags: # Caching & Performance +> Edge caching via Cache-Control headers reduces latency and server load for heavy static content. +
+ For Strapi Cloud applications with large amounts of cacheable content, such as images, videos, and other static assets, enabling CDN (Content Delivery Network) caching via the can help improve application performance. CDN caching can help improve application performance in a few ways: diff --git a/docusaurus/docs/cloud/projects/collaboration.md b/docusaurus/docs/cloud/projects/collaboration.md index 5244ef9bb5..fbfe5d5299 100644 --- a/docusaurus/docs/cloud/projects/collaboration.md +++ b/docusaurus/docs/cloud/projects/collaboration.md @@ -12,6 +12,8 @@ tags: # Collaboration on projects +> Project owners invite maintainers through the Share button, manage pending invitations, and revoke access. +
Projects are created by a user via their Strapi Cloud account. Strapi Cloud users can share their projects to anyone else, so these new users can have access to the project dashboard and collaborate on that project, without the project owner to ever have to share their credentials. diff --git a/docusaurus/docs/cloud/projects/deploys-history.md b/docusaurus/docs/cloud/projects/deploys-history.md index 56fbb38699..f6dc7a0afb 100644 --- a/docusaurus/docs/cloud/projects/deploys-history.md +++ b/docusaurus/docs/cloud/projects/deploys-history.md @@ -14,6 +14,9 @@ tags: # Deployment history and logs {#deploy-history-and-logs} +> Deployments tab lists every build with status and allows deep inspection of build and runtime logs. +
+ For each Strapi Cloud project, you can access the history of all deployments that occurred and their details including build and deployment logs. This information is available in the *Deployments* tab. ## Viewing the deployment history {#viewing-deploy-history} diff --git a/docusaurus/docs/cloud/projects/deploys.md b/docusaurus/docs/cloud/projects/deploys.md index a25fdff3f8..1e20f8b80a 100644 --- a/docusaurus/docs/cloud/projects/deploys.md +++ b/docusaurus/docs/cloud/projects/deploys.md @@ -15,6 +15,9 @@ pagination_next: cloud/projects/deploys-history # Deployments management +> Deployment triggers can be manual or automatic on git pushes, with the ability to cancel active builds from dashboard or CLI. +
+ The creation of a new Strapi Cloud project automatically trigger the deployment of that project. After that, deployments can be: - manually triggered whenever needed, [from the Cloud dashboard](#triggering-a-new-deployment) or [from the CLI](/cloud/cli/cloud-cli#strapi-deploy), diff --git a/docusaurus/docs/cloud/projects/notifications.md b/docusaurus/docs/cloud/projects/notifications.md index 069c687949..a0a4f1b955 100644 --- a/docusaurus/docs/cloud/projects/notifications.md +++ b/docusaurus/docs/cloud/projects/notifications.md @@ -12,6 +12,9 @@ tags: # Notifications +> Bell icon opens a feed of recent deployment events, automatically purged after 30 days. +
+ The Notification center can be opened by clicking the bell icon in the top navigation of the Cloud dashboard. It displays a list of the latest notifications for all your existing projects. Clicking on a notification card from the list will redirect you to the *Log details* page of the corresponding deployment (more information in [Deploy history & logs](/cloud/projects/deploys-history#accessing-deployment-details--logs)). diff --git a/docusaurus/docs/cloud/projects/overview.md b/docusaurus/docs/cloud/projects/overview.md index 22cd02b37e..add9eb2114 100644 --- a/docusaurus/docs/cloud/projects/overview.md +++ b/docusaurus/docs/cloud/projects/overview.md @@ -13,6 +13,9 @@ import ScreenshotNumberReference from '/src/components/ScreenshotNumberReference # Projects overview +> Projects page lists all apps with status and quick actions; selecting one opens a dashboard with metrics and controls. +
+ The *Projects* page displays a list of all your Strapi Cloud projects. From here you can manage your projects and access the corresponding applications. Runtime logs tab streams live server output, though Free plan logs reset when apps scale to zero. +
+ From a chosen project's dashboard, the *Runtime logs* tab displays the live logs of the project. :::note diff --git a/docusaurus/docs/cloud/projects/settings.md b/docusaurus/docs/cloud/projects/settings.md index 29bea264bb..c7dcbd19bc 100644 --- a/docusaurus/docs/cloud/projects/settings.md +++ b/docusaurus/docs/cloud/projects/settings.md @@ -16,6 +16,9 @@ import InvoiceStatus from '/docs/snippets/invoices-statuses.md' # Project settings +> Settings area spans project-level controls (general, billing, plans, invoices) and per-environment configuration. +
+ From a chosen project's dashboard, the **Settings** button, located in the header, enables you to manage the configurations and settings for your Strapi Cloud project and its environments. The settings' menu on the left side of the interface is separated into 2 categories: the settings for the entire project and the settings specific to any configured environment for the project.