Fix favicon configuration bug

.github/ISSUE_TEMPLATE/BUG_REPORT.yml

@@ -1,7 +1,5 @@
-name: Documentation Bug Report
+name: Documentation Issue
 description: Create a report to help us improve the Strapi documentation.
-title: "[Bug]: "
-labels: "type: bug"
 body:
   - type: input
     attributes:

.markdownlint.jsonc

@@ -0,0 +1,7 @@
+{
+  "default": true,
+  "no-hard-tabs": true,
+  "MD025": false,
+  "MD013": false,
+  "MD033": false
+}

.sclt-changelog.json

@@ -3,7 +3,7 @@
   "labelsToHeadline": {
     "new content": "✨ New content",
     "updated content": "🖌 Updated content",
-    "chore": "🧹 Chore, fixes, typos, and other improvements"
+    "fix": "🧹 Fixes, typos, chore, and other improvements"
   },
   "footer": "<br />Thanks a lot for your contributions! 🥰🚀"
 }

CONTRIBUTING.md

@@ -17,6 +17,10 @@ Contributing to the Strapi documentation implies 2 steps:
 
 2. [Submit a pull request](#-pull-requests) for review.
 
+***
+*Please note*: The Strapi Documentation team is currently not accepting new deployment or integration guides. These guides will soon be moved to another resource and probably only maintained by the Strapi Community while the Strapi Documentation team will focus on documenting only core Strapi products and features. Thank you for your understanding 🙏
+***
+
 ## 🦖 Docusaurus
 
 Strapi’s documentation is built with the React- and Markdown-based [Docusaurus](https://docusaurus.io) framework.
@@ -45,6 +49,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:** If you use an automatic formatter in your code editor (e.g., Prettier), **please disable it** as it could add unnecessary changes to your pull request or cause rendering issues because some Markdown formatting is based on whitespace.
+
 ### Working locally: Set up the project
 
 To set up the Docusaurus project on your machine, perform the following steps from a terminal instance:

README.md

@@ -9,17 +9,27 @@
 
 ---
 
-If you are looking for the Strapi code, please see the [Strapi Monorepo](https://github.com/strapi/strapi). This Repo is only for our [documentation](https://docs.strapi.io).
+If you are looking for the Strapi code, please see the [Strapi Monorepo](https://github.com/strapi/strapi). The present repository is only for the official Strapi documentation hosted at [docs.strapi.io](https://docs.strapi.io). Blog articles hosted at [strapi.io/blog](https://strapi.io/blog) and [community content](https://github.com/strapi/community-content) are not covered by the present repository either.
 
 ---
 
-Strapi is a free and open-source headless CMS delivering your content anywhere you need.
+Strapi is a free and open-source headless CMS that delivers your content anywhere you need.
 
 - **Keep control over your data**. With Strapi, you know where your data is stored, and you keep full control at all times.
 - **Self-hosted**. You can host and scale Strapi projects the way you want. You can choose any hosting platform you want: AWS, Netlify, Heroku, a VPS, or a dedicated server. You can scale as you grow, 100% independent.
 - **Database agnostic**. You can choose the database you prefer. Strapi works with SQL databases: PostgreSQL, MySQL, MariaDB, and SQLite.
 - **Customizable**. You can quickly build your logic by fully customizing APIs, routes, or plugins to fit your needs perfectly.
 
+## Documentation websites
+
+The main official Strapi documentation website is hosted at [docs.strapi.io](https://docs.strapi.io).
+
+Additional official Strapi documentation websites cover different content:
+
+- Documentation for the older, unsupported version 3 of Strapi is hosted at [docs-v3.strapi.io](https://docs-v3.strapi.io).
+- Upcoming and/or experimental documentation is hosted at [docs-next.strapi.io](https://docs-next.strapi.io). Starting autumn/winter 2023, this website will include in-progress documentation for Strapi v5.
+- Documentation for contributors, which include more in-depth and experimental content for developers who actively maintain and contribute to Strapi, is hosted at [contributor.strapi.io](https://contributor.strapi.io). This experimental documentation is maintained by Strapi engineers and any issue should be reported to the [`strapi/strapi`](https://github.com/strapi/strapi/issues/new/choose) repository.
+
 ## Contribution requirements
 
 The following are required if you are submitting pull requests to the documentation:
@@ -30,22 +40,22 @@ The following are required if you are submitting pull requests to the documentat
 
 👉 For more information on how to contribute, please read our [contribution guide](./CONTRIBUTING.md).
 
-## Requests
-
-Requests for new documentation are highly encouraged, this is not limited to new additions but also changes or more information requested on existing documentation. Please use our [request documentation](https://github.com/strapi/documentation/issues/new?template=DOC_REQUEST.md&title%5B%5D=REQUEST) issue template.
-
-## Bugs
+## Issues
 
-Bug reports help to improve the documentation. Please use our [documentation bug report](https://github.com/strapi/documentation/issues/new?template=BUG_REPORT.yml) template to report documentation bugs. To submit an issue:
+Submitting issues help to improve the documentation. If you find incorrect screenshot(s), instructions, or code examples, or if you discover UX/UI bugs on the website, please use our [documentation issue](https://github.com/strapi/documentation/issues/new?template=BUG_REPORT.yml) template to report them. To submit an issue:
 
-1. Verify the issue is only with the Strapi documentation, code issues should be directed at the main [strapi/strapi](https://github.com/strapi/strapi) repository.
+1. Verify the issue is only with one of the Strapi documentation websites. Product-related issues, missing Strapi features, and any issues not directly related to the documentation should be directed at the main [strapi/strapi](https://github.com/strapi/strapi) repository. Updates to blog posts found at [strapi.io/blog](https://strapi.io/blog) are also outside the scope of the present documentation repository; you can either reach the author of the blog post directly or use the [contact form](https://strapi.io/contact) on Strapi's corporate website if you have questions about blog posts.
 2. Follow the issue template and fill out as much information as you can.
 
 Technical questions should be asked using the following resources:
 
 - Open a Q&A thread on our [official forum](https://forum.strapi.io).
 - Engage with other community members on our [community Discord server](https://discord.strapi.io).
 
+## Requests
+
+Requests for new documentation are highly encouraged. This is not limited to new additions but also changes or more information requested on existing documentation. Please use our [request documentation](https://github.com/strapi/documentation/issues/new?template=DOC_REQUEST.md&title%5B%5D=REQUEST) issue template. These requests will be checked by the Strapi Documentation team then transferred to another internal tool outside GitHub for priorization and subsequent actions.
+
 ## Releases
 
 Thanks to a continuous integration/continuous delivery workflow, the Strapi documentation can be updated up to several times a day, depending on the number and frequency of contributions. Weekly snapshot [releases](https://github.com/strapi/documentation/releases) happen on Wednesdays and include a list of changes since the latest release.

docusaurus/docs/cloud/account/account-billing.md

@@ -0,0 +1,72 @@
+---
+title: Account billing & invoices
+displayed_sidebar: cloudSidebar
+description: Manage billing details and invoices for Strapi Cloud account.
+canonicalUrl: https://docs.strapi.io/cloud/account/account-billing.html
+---
+
+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.
+
+## 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.
+
+<ThemedImage
+  alt="Billing tab of Profile page"
+  sources={{
+      light: '/img/assets/cloud/account-billing2.png',
+      dark: '/img/assets/cloud/account-billing2_DARK.png',
+    }}
+/>
+
+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.
+
+### 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.
+2. Fill in the following fields:
+
+| Field name | Description |
+| --- | --- |
+| Card Number | Write the number of the credit card to add as payment method. |
+| Expires | Write the expiration date of the credit card. |
+| CVC | Write the 3-numbers code displayed at the back of the credit card. |
+
+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**.
+:::
+
+### 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.
+2. Click **Remove card**. The card is immediately deleted.
+
+:::note
+You cannot delete the primary card as at least one credit card must be available as payment method, and the primary card is by default that one. If the credit card you wish to delete is currently the primary card, you must first define another credit card as primary, then delete it.
+:::
+
+## Account invoices
+
+The ![Invoices icon](/img/assets/icons/Invoice.svg) *Invoices* tab displays the complete list of invoices for all your Strapi Cloud projects.
+
+<ThemedImage
+  alt="Invoices tab of Profile page"
+  sources={{
+      light: '/img/assets/cloud/account-invoices.png',
+      dark: '/img/assets/cloud/account-invoices_DARK.png',
+    }}
+/>
+
+<InvoiceStatus components={props.components} />
+
+:::strapi Invoices are also available per project.
+In the *Settings > Invoices* tab of any project, you will find the invoices for that project only. Feel free to check the [dedicated documentation](/cloud/projects/settings#invoices).
+:::

docusaurus/docs/cloud/account/account-settings.md

@@ -0,0 +1,56 @@
+---
+title: Profile settings
+displayed_sidebar: cloudSidebar
+description: Manage Strapi Cloud account settings.
+canonicalUrl: https://docs.strapi.io/cloud/account/account-settings.html
+---
+
+# Profile settings
+
+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 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).
+
+## General
+
+The ![General icon](/img/assets/icons/Faders.svg) *General* tab enables you to edit the following details for your account profile:
+
+- Details: to see the name associated with your account.
+- Connected accounts: to manage Google, GitHub and GitLab accounts connected with your Strapi Cloud account (see [Managing connected accounts](#managing-connected-accounts)).
+- Delete account: to permanently delete your Strapi Cloud account (see [Deleting Strapi Cloud account](#deleting-strapi-cloud-account)).
+
+<ThemedImage
+  alt="General tab of Profile page"
+  sources={{
+    light: '/img/assets/cloud/settings-general.png',
+    dark: '/img/assets/cloud/settings-general_DARK.png',
+  }}
+/>
+
+### Managing connected accounts
+
+You can connect a Google, GitLab and GitHub account to your Strapi Cloud account. The _Connected accounts_ section lists accounts that are currently connected to your Strapi Cloud account. From there you can also connect a new Google, GitLab and GitHub account if one is not already connected.
+
+To connect a new Google, GitLab or GitHub account to your Strapi Cloud account, click on the **Connect account** button and follow the next steps on the corresponding website.
+
+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.
+
+### 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.
+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',
+  }}
+/>

docusaurus/docs/cloud/advanced/database.md

@@ -9,19 +9,20 @@ canonicalUrl: https://docs.strapi.io/cloud/advanced/database.html
 
 Strapi Cloud provides a pre-configured PostgreSQL database by default. However, you can also configure it to utilize an external SQL database, if needed.
 
-:::caution
-While possible, it is not recommended to use an external database with Strapi Cloud, unless there is an explicit need to do so. This is because Strapi Cloud provides a managed database that is optimized for Strapi. Using an external database may result in unexpected behavior and/or performance issues (e.g., network latency may impact performance). Strapi cannot provide security or support with configuring external databases.
-
-:::
-
 :::prerequisites
-
-- A local Strapi project running on `v4.8.1+`.
+- A local Strapi project running on `v4.8.2+`.
 - Credentials for external database.
 - If using an existing database, the schema must match the Strapi project schema.
+:::
 
+:::caution
+While it's possible to use an external database with Strapi Cloud, you should do it while keeping in mind the following considerations:
+- Strapi Cloud already provides a managed database that is optimized for Strapi.
+- Using an external database may result in unexpected behavior and/or performance issues (e.g., network latency may impact performance). For performance reasons, it's recommended to host your external database close to the region where your Strapi Cloud project is hosted. You can find where your Strapi Cloud project is hosted in your Project Settings (see [Project Settings > General > Selected Region](/cloud/projects/settings#general)).
+- Strapi can't provide security or support with external databases used with Strapi Cloud.
 :::
 
+
 ## Configuration
 
 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.
@@ -47,14 +48,19 @@ Before pushing changes, add environment variables to the Strapi Cloud project:
 
 :::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.
 
-![deployment](https://res.cloudinary.com/dz7knyfbp/image/upload/v1681936928/deploy_h49uly.png)
+<ThemedImage
+  alt="Deployment"
+  sources={{
+    light: '/img/assets/cloud/deploy-logs.png',
+    dark: '/img/assets/cloud/deploy-logs_DARK.png',
+  }}
+/>
 
 Once the application finishes building, the project will use the external database.