strapi · jb-thery · Oct 28, 2024 · Oct 28, 2024 · Oct 28, 2024 · Oct 28, 2024
@@ -0,0 +1,23 @@
+name: Auto Label PRs
+on:
+  pull_request:
+    types:
+      - opened
+
+jobs:
+  auto-label:
+    runs-on: ubuntu-latest
+    permissions:
+      pull-requests: write
+
+    steps:
+      - name: Add label to PR
+        uses: actions/github-script@v7
+        with:
+          script: |
+            await github.rest.issues.addLabels({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              issue_number: context.issue.number,
+              labels: ['temp: port to doc6']
+            });
@@ -45,6 +45,8 @@ The Strapi Documentation team has created a complete style guide for you to make
 
 💁 While writing, please consider the [12 Rules of Technical Writing](https://handbook.strapi.io/user-success-manual/12-rules-of-technical-writing) that the Strapi Documentation team will use to assess the quality and consistency of the contribution. 😊
 
+⚠️ **Important: Please disable any linter or automatic formatting tool(s)** before saving and submitting your files. Not doing so could, at best, add unnecessary formatting changes to the submitted PR or, at worst, prevent Docusaurus from properly rendering some pages.
+
 ### Working locally: Set up the project
 
 To set up the Docusaurus project on your machine, perform the following steps from a terminal instance:

@@ -2,9 +2,7 @@ Copyright (c) 2015-present Strapi Solutions SAS
 
 Portions of the Strapi software are licensed as follows:
 
-* All software that resides under an "ee/" directory (the “EE Software”), if that directory exists, is licensed under the license defined in "ee/LICENSE".
-
-* All software outside of the above-mentioned directories or restrictions above is available under the "MIT Expat" license as set forth below.
+* All software is available under the "MIT Expat" license as set forth below.
 
 MIT Expat License
 

@@ -16,11 +16,11 @@ import InvoiceStatus from '/docs/snippets/invoices-statuses.md'
 
 # Account billing & invoices 
 
-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 icon](/img/assets/icons/CreditCard.svg) *Billing*](#account-billing) and [![Invoices icon](/img/assets/icons/Invoice.svg) *Invoices*](#account-invoices) tabs.
+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 <Icon name="credit-card" /> [*Billing*](#account-billing) and <Icon name="invoice" /> [*Invoices*](#account-invoices) tabs.
 
 ## Account billing
 
-The ![Billing icon](/img/assets/icons/CreditCard.svg) *Billing* tab displays and enables you to modify the billing details and payment method set for the account.
+The <Icon name="credit-card" /> *Billing* tab displays and enables you to modify the billing details and payment method set for the account.
 
 <ThemedImage
   alt="Billing tab of Profile page"
@@ -30,11 +30,11 @@ The ![Billing icon](/img/assets/icons/CreditCard.svg) *Billing* tab displays and
     }}
 />
 
-The *Payment method* section of the ![Billing icon](/img/assets/icons/CreditCard.svg) *Billing* tab allows you to manage the credit cards that can be used for the Strapi Cloud projects. The *Billing details* section requires to be filled in, at least for the mandatory fields, as this information will be the default billing details for all Strapi Cloud projects related to your account.
+The *Payment method* section of the <Icon name="credit-card" /> *Billing* tab allows you to manage the credit cards that can be used for the Strapi Cloud projects. The *Billing details* section requires to be filled in, at least for the mandatory fields, as this information will be the default billing details for all Strapi Cloud projects related to your account.
 
 ### Adding a new credit card
 
-1. In the *Payment method* section of the ![Billing icon](/img/assets/icons/CreditCard.svg) *Billing* tab, click on the **Add card** button.
+1. In the *Payment method* section of the <Icon name="credit-card" /> *Billing* tab, click on the **Add card** button.
 2. Fill in the following fields:
 
 | Field name | Description |
@@ -46,14 +46,15 @@ The *Payment method* section of the ![Billing icon](/img/assets/icons/CreditCard
 3. Click on the **Save** button.
 
 :::tip
-The first credit card to be added as payment method for the account will by default be the primary one. It is however possible to define another credit card as primary by clicking on the ![Menu icon](/img/assets/icons/more.svg) icon, then **Switch as primary**.
+- The first credit card to be added as payment method will be by default the primary card. You can change the role by clicking on the <Icon name="dots-three-outline" /> icon, then **Set as primary** on another card.
+- Be aware that you also have the possibility to use a dedicated card at projects-level. It will allow you to use different cards for different projects (see [Project Settings > Billing & Usage](/cloud/projects/settings#billing--usage)).
 :::
 
 ### Deleting a credit card
 
 To remove a credit card from the list of payment methods for the account:
 
-1. Click on the ![Menu icon](/img/assets/icons/more.svg) icon of the credit card you wish to delete.
+1. Click on the <Icon name="dots-three-outline" /> icon of the credit card you wish to delete.
 2. Click **Remove card**. The card is immediately deleted.
 
 :::note
@@ -62,7 +63,7 @@ You cannot delete the primary card as at least one credit card must be available
 
 ## Account invoices
 
-The ![Invoices icon](/img/assets/icons/Invoice.svg) *Invoices* tab displays the complete list of invoices for all your Strapi Cloud projects.
+The <Icon name="invoice" /> *Invoices* tab displays the complete list of invoices for all your Strapi Cloud projects.
 
 <ThemedImage
   alt="Invoices tab of Profile page"

@@ -17,7 +17,7 @@ pagination_next: cloud/account/account-billing
 
 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 4 tabs available in the *Profile* interface: ![General icon](/img/assets/icons/Faders.svg) [*General*](#general), ![Preferences icon](/img/assets/icons/Palette.svg) [*Preferences*](#preferences), ![Billing icon](/img/assets/icons/CreditCard.svg) *Billing* and ![Invoices icon](/img/assets/icons/Invoice.svg) Invoices (the last 2 are documented in the [Account billing details](/cloud/account/account-billing) section of this documentation).
+There are 3 tabs available in the *Profile* interface: ![General icon](/img/assets/icons/Faders.svg) [*General*](#general), ![Billing icon](/img/assets/icons/CreditCard.svg) *Billing* and ![Invoices icon](/img/assets/icons/Invoice.svg) Invoices (the last 2 are documented in the [Account billing details](/cloud/account/account-billing) section of this documentation).
 
 ## General
 
@@ -43,22 +43,14 @@ To connect a new Google, GitLab or GitHub account to your Strapi Cloud account,
 
 You can also click on the three dots button of a connected account and click on the "Manage on" button to manage your GitHub, GitLab or Google account directly on the corresponding website.
 
+:::caution <NewBadge />
+For GitLab, Groups and Subgroups organizations are not supported at the moment.
+:::
+
 ### Deleting Strapi Cloud account
 
 You can delete your Strapi Cloud account, but it will be permanent and irreversible. All associated projects and their data will be deleted as well and the subscriptions for the projects will automatically be canceled.
 
-1. In the *Delete account* section of the ![General icon](/img/assets/icons/Faders.svg) *General* tab, click on the **Delete account** button.
+1. In the *Delete account* section of the <Icon name="faders" /> *General* tab, click on the **Delete account** button.
 2. In the dialog, type `DELETE` in the textbox.
 3. Confirm the deletion of your account by clicking on the **Delete** button.
-
-## Preferences
-
-The ![Preferences icon](/img/assets/icons/Palette.svg) *Preferences* tab enables you to choose the appearance of your Strapi Cloud dashboard: either the Light or Dark theme.
-
-<ThemedImage
-  alt="Preferences tab of Profile page"
-  sources={{
-    light: '/img/assets/cloud/account-preferences.png',
-    dark: '/img/assets/cloud/account-preferences_DARK.png',
-  }}
-/>
@@ -30,9 +30,12 @@ While it's possible to use an external database with Strapi Cloud, you should do
 - Strapi can't provide security or support with external databases used with Strapi Cloud.
 :::
 
-
 ## Configuration
 
+:::caution
+To ensure a smooth deployment, it is recommended to not change the names of the environment variables.
+:::
+
 The project `./config/database.js` or `./config/database.ts` file must match the configuration found in the [environment variables in database configurations](https://docs.strapi.io/dev-docs/configurations/database#environment-variables-in-database-configurations) section.
 
 Before pushing changes, add environment variables to the Strapi Cloud project:
@@ -54,10 +57,6 @@ Before pushing changes, add environment variables to the Strapi Cloud project:
 
 4.  Click **Save**.
 
-:::caution
-To ensure a smooth deployment, it is recommended to not change the names of the environment variables.
-:::
-
 ## Deployment
 
 To deploy the project and utilize the external database, push the changes from earlier. This will trigger a rebuild and new deployment of the Strapi Cloud project.

@@ -42,7 +42,11 @@ Using either `npm` or `yarn`, install the provider plugin in your local Strapi p
 
 ### Configure the Provider
 
-In your Strapi project, create a `./config/env/production/plugins.js` or `./config/env/production/plugins.ts` file with the following content:
+:::caution
+The file structure must match the below path **exactly**, or the configuration will not be applied to Strapi Cloud.
+:::
+
+To configure a 3rd-party email provider in your Strapi project, create or edit the plugins configuration file for your production environment `./config/env/production/plugins.js|ts` by adding upload configuration options as follows:
 
 <Tabs groupId="js-ts">
 <TabItem value="js" label="JavaScript">
@@ -84,10 +88,6 @@ export default ({ env }) => ({
 
 </Tabs>
 
-:::caution
-The file structure must match the above path exactly, or the configuration will not be applied to Strapi Cloud.
-:::
-
 Each provider will have different configuration settings available. Review the respective entry for that provider in the [Marketplace](https://market.strapi.io/providers).
 
 **Example:**

@@ -44,6 +44,10 @@ Using either `npm` or `yarn`, install the provider plugin in your local Strapi p
 
 ### Configure the Provider
 
+:::caution
+The file structure must match the below path **exactly**, or the configuration will not be applied to Strapi Cloud.
+:::
+
 To configure a 3rd-party upload provider in your Strapi project, create or edit the plugins configuration file for your production environment `./config/env/production/plugins.js|ts` by adding upload configuration options as follows:
 
 <Tabs groupId="js-ts">
@@ -85,10 +89,6 @@ upload: {
 </TabItem>
 </Tabs>
 
-:::caution
-The file structure must match the above path exactly, or the configuration will not be applied to Strapi Cloud.
-:::
-
 Each provider will have different configuration settings available. Review the respective entry for that provider in the [Marketplace](https://market.strapi.io/providers).
 
 **Example:**

@@ -9,7 +9,7 @@ tags:
 pagination_next: cloud/advanced/database
 ---
 
-# Command Line Interface (CLI) <NewBadge />
+# Command Line Interface (CLI)
 
 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.
 
@@ -41,34 +41,44 @@ Deploy a new local project (< 100MB) in Strapi Cloud.
 strapi deploy
 ```
 
-This command must be used after the `login` one. It deploys a local Strapi project on Strapi Cloud, without having to host it on a remote git repository beforehand. The terminal will inform you when the project is successfully deployed on Strapi Cloud.
+This command must be used after the `login` one. It deploys a local Strapi project on Strapi Cloud, without having to host it on a remote git repository beforehand.
 
-Once the project is first deployed on Strapi Cloud with the CLI, the `deploy` command can be reused to trigger a new deployment of the same project.
-
-:::caution
-The `deploy` command can only be used by new users who have never created a Strapi Cloud project, and for which the free trial is still available. Once a project is deployed with the CLI, it isn't possible to deploy another project on the same Strapi Cloud account with the CLI.
+:::note
+If you have any free trial available, the deploy command will create automatically a new project on Strapi Cloud, unless you previously link your local project to an existing project by using the `strapi link` command.
 :::
 
+When you use this command, you’ll be asked to select a target environment. To skip this prompt, you can either:
+- Use the `--env` flag (e.g., `strapi deploy --env <environment-name>`)
+- Set a default environment with `strapi cloud environment link` [command](#cloud-environment-link), so deployments automatically go to that environment.
+
+The terminal will inform you when the project is successfully deployed on Strapi Cloud.
+
+Once the project is first deployed on Strapi Cloud with the CLI, the `deploy` command can be reused to trigger a new deployment of the same project.
+
 :::note
 Once you deployed your project, if you visit the Strapi Cloud dashboard, you may see some limitations as well as impacts due to creating a Strapi Cloud project that is not in a remote repository and which was deployed with the CLI.
 
 - Some areas in the dashboard that are usually reserved to display information about the git provider will be blank.
 - Some buttons, such as the **Trigger deploy** button, will be greyed out and unclickable since, unless you have [connected a git repository to your Strapi Cloud project](/cloud/getting-started/deployment-cli#automatically-deploying-subsequent-changes).
 :::
 
-## strapi link <NewBadge />
+## strapi link
 
 **Alias:** `strapi cloud:link`
 
 Links project in current folder to an existing project in Strapi Cloud.
 
+:::note
+Linking a project to Strapi Cloud doesn't limit it to Strapi Cloud alone; you can still deploy and manage it in your own self-hosted environment as needed.
+:::
+
 ```bash
 strapi link
 ```
 
 This command connects your local project in the current directory with an existing project on your Strapi Cloud account. You will be prompted to select the project you wish to link from a list of available projects hosted on Strapi Cloud.
 
-## strapi projects <NewBadge />
+## strapi projects
 
 **Alias:** `strapi cloud:projects`
 
@@ -78,7 +88,34 @@ Lists all Strapi Cloud projects associated with your account.
 strapi projects
 ```
 
-This command retrieves and displays a list of all projects hosted on your Strapi Cloud account.
+
+```bash
+strapi link
+```
+
+This command connects your local project in the current directory with an existing project on your Strapi Cloud account. You will be prompted to select the project you wish to link from a list of available projects hosted on Strapi Cloud.
+
+## strapi cloud environments <NewBadge /> {#cloud-environments}
+
+**Alias:** `strapi cloud environment list`
+
+Lists all environments associated with your Strapi Cloud Project.
+
+```bash
+strapi cloud environments
+```
+
+This command retrieves and displays a list of all environments belonging to your Strapi Cloud project.
+
+## strapi cloud environment link <NewBadge /> {#cloud-environment-link}
+
+Links your local project to a specific environment in your Strapi Cloud project.
+
+```bash
+strapi cloud environment link
+```
+
+This command shows a list of all environments in your Strapi Cloud project and lets you choose one. The selected environment will then be the default for direct deployments.
 
 ## strapi logout
 

@@ -14,9 +14,9 @@ Before going any further into this Strapi Cloud documentation, we recommend you
 
 - **Hosting Platform** <br/> Strapi Cloud is a hosting platform that allows to deploy already existing Strapi projects created with Strapi CMS (Content Management System). Strapi Cloud is *not* the SaaS (Software as a Service) version of Strapi CMS. Feel free to refer to the [Developer Documentation](https://docs.strapi.io/dev-docs/intro) and [User Guide](https://docs.strapi.io/user-docs/intro) to learn more about Strapi CMS.
 
-- **Strapi Cloud Pricing Plans** <br/> As a Strapi Cloud user you have the choice between 3 tiers: Developer, Pro and Team. Depending on the tier, you have access to different functionalities, support and customization options (see [Pricing page](https://strapi.io/pricing-cloud) for more details). In this Strapi Cloud documentation, the <CloudDevBadge />, <CloudProBadge />, and <CloudTeamBadge /> badges can be displayed beside a section's title to indicate for which tier the feature is available.
+- **Strapi Cloud Pricing Plans** <br/> As a Strapi Cloud user you have the choice between 3 tiers: Developer, Pro and Team. Depending on the tier, you have access to different functionalities, support and customization options (see [Pricing page](https://strapi.io/pricing-cloud) for more details). In this Strapi Cloud documentation, the <CloudDevBadge />, <CloudProBadge />, and <CloudTeamBadge /> badges can be displayed below a section's title to indicate for which tier the feature is available.
 
-- **Strapi CMS Enterprise features** <br/> Some of Strapi features, usually accessible via the Enterprise Edition of Strapi CMS, are included in some Strapi Cloud tiers (see [Pricing page](https://strapi.io/pricing-cloud) and [Information on billing & usage](/cloud/getting-started/usage-billing) for more details). These features, highlighted with an <EnterpriseBadge /> badge, are documented in the [User Guide](https://docs.strapi.io/user-docs/intro) and the [Developer Documentation](https://docs.strapi.io/dev-docs/intro).
+- **Strapi CMS features** <br/> The Strapi Cloud plans include some Strapi CMS features (see [Pricing page](https://strapi.io/pricing-cloud) for more details). These features, highlighted with a <GrowthBadge /> or an <EnterpriseBadge /> badge, are documented in the [User Guide](https://docs.strapi.io/user-docs/intro) and the [Developer Documentation](https://docs.strapi.io/dev-docs/intro).
 
 - **Types of Strapi Cloud users** <br/> There can be 2 types of users on a Strapi Cloud project: owners and maintainers. The owner is the one who has created the project and has therefore access to all features and options for the project. Maintainers are users who have been invited to contribute to an already created project by its owner. Maintainers, as documented in the [Collaboration](/cloud/projects/collaboration) page, cannot view and access all features and options from the Strapi Cloud dashboard.