Merge branch 'main' into davlgd-changelog-php-8.4

.github/styles/config/vocabularies/Doc/accept.txt

@@ -29,6 +29,7 @@ Gemfile
 Glassfish
 Gradle
 gradle
+Grafana
 healthcheck
 Heptapod
 Hextra

.github/workflows/external-doc-update.yml

@@ -9,6 +9,7 @@ jobs:
   changed_files:
     runs-on: ubuntu-latest
     name: Test changed-files
+    environment: update doc
     # Needed to post comments and create issues
     permissions:
         issues: write
@@ -30,6 +31,7 @@ jobs:
         with:
           files: |
             content/guides/astro.md
+            context/guides/nuxt.md
       
       # Create issue and assign PR author
       - name: Create issue
@@ -48,18 +50,18 @@ jobs:
           search_existing: all
 
       # Post a single comment with auto-updating body
-      - name: Create or update a comment
-        env:
-          CHANGED_FILES: ${{ steps.changed-files-specific.outputs.all_changed_files }}
-        uses: taoliujun/action-unique-comment@v1
-        with:
-          uniqueIdentifier: ${{ github.workflow }}
-          body: |
-            You updated ${{ env.CHANGED_FILES }}. This content is also listed on external doc. Issue number ${{ steps.create-issue.outputs.number }} has been created and assigned to you 🫵👁️👄👁️
-            
-            See it or modify it here: 
-              * ${{ steps.create-issue.outputs.url }}
-            
-            _This unique comment uses the very cool [taoliujun/action-unique-comment](https://github.com/marketplace/actions/unique-comment). Thank you <3_
+      #- name: Create or update a comment
+      #  env:
+      #    CHANGED_FILES: ${{ steps.changed-files-specific.outputs.all_changed_files }}
+      #  uses: taoliujun/action-unique-comment@v1
+      #  with:
+      #    uniqueIdentifier: ${{ github.workflow }}
+      #    body: |
+      #      You updated ${{ env.CHANGED_FILES }}. This content is also listed on external doc. Issue number ${{ steps.create-issue.outputs.number }} has been created and assigned to you 🫵👁️👄👁️
+      #      
+      #      See it or modify it here: 
+      #        * ${{ steps.create-issue.outputs.url }}
+      #      
+      #      _This unique comment uses the very cool [taoliujun/action-unique-comment](https://github.com/marketplace/actions/unique-comment). Thank you <3_
 
 

.github/workflows/review-app.yml

@@ -23,20 +23,20 @@ jobs:
           token: ${{ secrets.GITHUB_TOKEN }}
           fetch-depth: 0
       - name: Manage review app
-        uses: CleverCloud/clever-cloud-review-app@v1.1.1
+        uses: CleverCloud/clever-cloud-review-app@beta
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
           CLEVER_SECRET: ${{ secrets.CLEVER_SECRET }}
           CLEVER_TOKEN: ${{ secrets.CLEVER_TOKEN }}
           ORGA_ID: ${{ secrets.ORGA_ID }}
           GH_CC_PRE_BUILD_HOOK: './clevercloud-deploy-script.sh'
           GH_CC_WEBROOT: '/public'
-          GH_HEXTRA_VERSION: 'v0.8.4'
+          GH_HEXTRA_VERSION: 'v0.9.3'
           GH_HUGO_ENV: 'production'
-          GH_HUGO_VERSION: '0.135.0'
+          GH_HUGO_VERSION: '0.140.2'
 
         with:
           type: 'static-apache'
           set-env: true
           environment: 'review'
-          domain: '${{ github.event.pull_request.base.repo.name }}-PR-${{ github.event.number }}.cleverapps.io/developers'
+          domain: '${{ github.event.pull_request.base.repo.name }}-PR-${{ github.event.number }}.cleverapps.io/developers'

CONTRIBUTING.md

@@ -1,8 +1,7 @@
 
 # Contributing guidelines
 
-This document provides explicit standards expected in Clever Cloud documentation. Inspiration and research for this document comes from [Google's Developer Documentation Style Guide](https://developers.google.com/style/tone), and the incredible [Awesome Code Review](https://github.com/joho/awesome-code-review) project.
-
+This document provides explicit standards expected in Clever Cloud documentation. Inspiration and research for this document comes from the incredible [Awesome Code Review](https://github.com/joho/awesome-code-review) project. 
 ## Standards
 
 Those are general standards to fulfill for every modification in this repository.
@@ -21,6 +20,8 @@ Follow the established structure in this doc. If you wish to propose changes to
 
 Follow these guidelines while writing new content. The goal is to help you write in a **clear, precise, and unambiguous language**. They're not meant to be a burden, but to help you deliver the best content possible.
 
+Sources for quality content are currently being updated.
+
 #### 👍 Do
 
 - **Don't assume the user "knows better":** if you think something is obvious, it's not. Better over-explain than under-explain.

assets/css/custom.css

@@ -234,9 +234,15 @@ html[class~="dark"] .content a:has(code){
 /* Display an arrow at the end of the linked variable */
 .content a:not(.code-block code) code::after {
   content: "\00a0↗";
-  color: tomato;
-  font-size: 1.1rem;
-
+    color: tomato;
+    font-size: 1rem;
+    bottom: -2px;
+    position: relative;
+    left: 4px;
+    width: 14px;
+    display: inline-block;
+    height: 14px;
+    line-height: 0.35em;
 }
 
 /* Display arrow for external links in the main menu.

clevercloud-deploy-script.sh

@@ -2,4 +2,5 @@ wget https://github.com/gohugoio/hugo/releases/download/v$HUGO_VERSION/hugo_exte
 tar xvf hugo_extended_"$HUGO_VERSION"_Linux-64bit.tar.gz
 chmod +x ./hugo
 ./hugo mod get github.com/imfing/hextra@$HEXTRA_VERSION
-./hugo --gc --minify --destination public/developers
+./hugo --gc --minify --destination public/developers
+echo "AddType text/markdown;charset=UTF-8 .md" > public/.htaccess

content/api/howto.md

@@ -55,11 +55,11 @@ You need to set a callback URL, this is the url your user will be redirected to
 
 #### **Get a request token**
 
-You have to make a `POST`request to get a [request token](/api/v2/#post-/oauth/request_token) to the API.
+You have to make a `POST`request to get a [request token](/developers/api/v2/#post-/oauth/request_token) to the API.
 
 #### **Get the authorization URL**
 
-Ask the API for the [authorization URL](/api/v2/#get-/oauth/authorize) and go to this URL with a browser. Log in with your account and it will send you to the callback URL.
+Ask the API for the [authorization URL](/developers/api/v2/#get-/oauth/authorize) and go to this URL with a browser. Log in with your account and it will send you to the callback URL.
 
 #### **Get the verifier token**
 
@@ -71,7 +71,7 @@ Where `<verifierToken>` is your token.
 
 #### **Get the access token**
 
-Make a `POST`  request to get the [access token](/api/v2/#post-/oauth/access_token) with your request token and the verifier.
+Make a `POST`  request to get the [access token](/developers/api/v2/#post-/oauth/access_token) with your request token and the verifier.
 You can use this access token to make OAuth1 signed requests.
 
 More information about [OAuth dance](https://oauth.net/core/1.0/#anchor9).
@@ -88,8 +88,8 @@ All the API endpoints are referenced in a swagger documentation. **The base URL
 
 {{< cards >}}
 
-  {{< card link="/api/v2" title="Base v2 Endpoints" subtitle="Our base API endpoints with users, organisations, applications, add-ons, etc." icon="endpoints" >}}
-  {{< card link="/api/v4" title="New v4 Endpoints" subtitle="More recent API endpoints with billing, deployments, load balancers, logs, etc." icon="new" >}}
+  {{< card link="/developers/api/v2/" title="Base v2 Endpoints" subtitle="Our base API endpoints with users, organisations, applications, add-ons, etc." icon="endpoints" >}}
+  {{< card link="/developers/api/v4/" title="New v4 Endpoints" subtitle="More recent API endpoints with billing, deployments, load balancers, logs, etc." icon="new" >}}
 
 {{< /cards >}}
 

content/api/v4.md

@@ -9,7 +9,7 @@ keywords:
 - endpoint
 - v4
 ---
-Clever Cloud provides a public REST API used by its own services and customers, known as [`/v2`](/api/v2). 
+Clever Cloud provides a public REST API used by its own services and customers, known as [`/v2`](/developers/api/v2/). 
 As our platform evolves, we're progressively moving to `/v4` endpoints, adding functionalities, with a more modern approach: 
 ```
 https://api.clever-cloud.com/v4/

content/changelog/2023-11-10-healthcheck-for-java.md → content/changelog/2023/11-10-healthcheck-for-java.md

@@ -9,6 +9,8 @@ authors:
     link: https://github.com/judu
     image: https://github.com/judu.png?size=40
 description: Your java applications can now be deployed with one or multiple custom healtchecks
+aliases:
+- /changelog/2023-11-10-healthcheck-for-java
 excludeSearch: true
 ---
 
@@ -19,4 +21,4 @@ You can now define the paths that the orchestrator will call to validate a deplo
 
 Currently, the orchestrator only checks whether the application is listening to TCP port `8080`. It does not always mean that the application has started correctly.
 
-- Read the documentation about [Deployment healthcheck path](../../doc/develop/healthcheck/) 📖
+- Read the documentation about [Deployment healthcheck path](/developers/doc/develop/healthcheck/) 📖

content/changelog/2023-11-29-api-update.md → content/changelog/2023/11-29-api-update.md

@@ -12,6 +12,8 @@ authors:
     link: https://github.com/davlgd
     image: https://github.com/davlgd.png?size=40
 description: You can now check if an application is a task via the Clever Cloud API
+aliases:
+- /changelog/2023-11-29-api-update
 excludeSearch: true
 ---
 For years, you can deploy applications on Clever Cloud as a `Task` with the API or more recently the `CC_TASK=true` environment variable. As this feature will be widely available and used, the API has been updated to return such a state in the `instance.lifetime` object:
@@ -40,4 +42,4 @@ For years, you can deploy applications on Clever Cloud as a `Task` with the API
 }
 ```
 
-You can read the full APIv2 documentation [here]({{< ref "/api/v2" >}} "OpenAPI").
+You can read the full APIv2 documentation [here](/developers/api/v2).

content/changelog/2023-12-13-cellar-migration-tool-update.md → content/changelog/2023/12-13-cellar-migration-tool-update.md

@@ -9,6 +9,8 @@ authors:
     link: https://github.com/BlackYoup
     image: https://github.com/BlackYoup.png?size=40
 description: Keep-alive support and better behavior during network errors
+aliases:
+- /changelog/2023-12-13-cellar-migration-tool-update
 excludeSearch: true
 ---
 

content/changelog/2023-12-15-sozu-0.15.18.md → content/changelog/2023/12-15-sozu-0.15.18.md

@@ -8,6 +8,8 @@ authors:
     link: https://github.com/FlorentinDUBOIS
     image: https://github.com/FlorentinDUBOIS.png?size=40
 description: Better, faster, stronger
+aliases:
+- /changelog/2023-12-15-sozu-0.15.18
 excludeSearch: true
 ---
 

content/changelog/2023-12-18-java-21-default.md → content/changelog/2023/12-18-java-21-default.md

@@ -9,9 +9,11 @@ authors:
     link: https://github.com/judu
     image: https://github.com/judu.png?size=40
 description: Deploy Java applications on Clever Cloud with version 21 as default
+aliases:
+- /changelog/2023-12-18-java-21-default
 excludeSearch: true
 ---
 
 Java version 21 is available on Clever Cloud for several weeks, but is now deployed as the default version for new applications. Of course, you can set the one of your choice between those available through `CC_JAVA_VERSION` environment variable.
 
-- Read our documentation [about Java]({{< ref "/doc/applications/java" >}} "Java Doc")
+- Read our documentation [about Java](/developers/doc/applications/java)

content/changelog/2023-12-18-new-par-ip-console.md → content/changelog/2023/12-18-new-par-ip-console.md

@@ -9,9 +9,11 @@ authors:
     link: https://github.com/GuillaumeASSIER
     image: https://github.com/GuillaumeASSIER.png?size=40
 description: New IP list for DNS of Clever Cloud PAR region in the Console
+aliases:
+- /changelog/2023-12-18-new-par-ip-console
 excludeSearch: true
 ---
 
 Setup of our new infrastructure in Paris implies addition of new IP which can be used for DNS entries. They are now detailed in the **Domain Names** section of your applications in the [Console](https://console.clever-cloud.com).
 
-{{< figure src="/images/changelog/console-new-ip-par.webp" caption="The new IP of the PAR region in the Console" width="800px">}}
+![New IP entries in Clever Cloud Console](/images/changelog/console-new-ip-par.webp "The new IP of the PAR region in the Console")

content/changelog/2023-12-18-php-8-default.md → content/changelog/2023/12-18-php-8-default.md

@@ -12,9 +12,11 @@ authors:
     link: https://github.com/judu
     image: https://github.com/judu.png?size=40
 description: Deploy PHP applications on Clever Cloud with latest version 8.x as default
+aliases:
+- /changelog/2023-12-18-php-8-default
 excludeSearch: true
 ---
 
 PHP 8.x is available for years on Clever Cloud, but is now deployed as the default version for new applications. Of course, you can set the one of your choice between those available through `CC_PHP_VERSION` environment variable.
 
-- Read our documentation [about PHP version]({{< ref "/doc/applications/php/#choose-your-php-version" >}} "Choose PHP version" )
+- Read our documentation [about PHP version](/developers/doc/applications/php/#choose-your-php-version)

content/changelog/2023-12-19-console-web-components-v12.md → content/changelog/2023/12-19-console-web-components-v12.md

@@ -9,6 +9,8 @@ authors:
     link: https://github.com/pdesoyres-cc
     image: https://github.com/pdesoyres-cc.png?size=40
 description: Console update with new icons for the documentation
+aliases:
+- /changelog/2023-12-19-console-web-components-v12
 excludeSearch: true
 ---
 
@@ -18,4 +20,4 @@ Among other changes under the hood, our [Console](https://console.clever-cloud.c
 
 Links to the new documentation are now available in the Console. They're more precise depending on the `variant` (e.g. PHP/Static), use small icons to boost visibility and are now effective for applications and add-ons:
 
-{{< figure src="/developers/images/changelog/doc-link-console.webp" caption="The new documentation link in the Console" >}}
+![The new documentation link in the Console](/images/changelog/doc-link-console.webp "The new documentation link in the Console")

content/changelog/2023-12-22-sozu-wider usage.md → content/changelog/2023/12-22-sozu-wider usage.md

@@ -1,5 +1,5 @@
 ---
-title: Wider Sōzu usage 
+title: Wider Sōzu usage
 date: 2023-12-22
 tags:
   - sozu
@@ -8,6 +8,8 @@ authors:
     link: https://github.com/FlorentinDUBOIS
     image: https://github.com/FlorentinDUBOIS.png?size=40
 description: Sōzu gets better and can be used on more services on Clever Cloud
+aliases:
+- /changelog/2023-12-22-sozu-wider usage
 excludeSearch: true
 ---
 

content/changelog/2024-01-02-pulsar-update.md → content/changelog/2024/01-02-pulsar-update.md

@@ -9,6 +9,8 @@ authors:
     link: https://github.com/kannarfr
     image: https://github.com/kannarfr.png?size=40
 description: The Clever Cloud Pulsar stack has been updated and is more stable
+aliases:
+- /changelog/2024-01-02-pulsar-update
 excludeSearch: true
 ---
 

content/changelog/2024-01-10-documentation-changelog.md → content/changelog/2024/01-10-documentation-changelog.md

@@ -15,7 +15,9 @@ authors:
     link: https://github.com/cnivolle
     image: https://github.com/cnivolle.png?size=40
 description: You can now check Clever Cloud's evolutions in our new changelog, RSS feed included
+aliases:
+- /changelog/2024-01-10-documentation-changelog
 excludeSearch: true
 ---
 
-A changelog has been [added](/changelog) to our [Developer Center](/). It will be regularly updated by the Clever Cloud teams to give you an overview of our new features, but also changes made and deprecations planned on the platform.
+A changelog has been [added](/developers/changelog) to our [Developer Center](/developers). It will be regularly updated by the Clever Cloud teams to give you an overview of our new features, but also changes made and deprecations planned on the platform.

content/changelog/2024-01-11-redis-7.2.4.md → content/changelog/2024/01-11-redis-7.2.4.md

@@ -9,6 +9,8 @@ authors:
     link: https://github.com/aurrelhebert
     image: https://github.com/aurrelhebert.png?size=40
 description: Use Redis 7.2 in its latest release on Clever Cloud
+aliases:
+- /changelog/2024-01-11-redis-7.2.4
 excludeSearch: true
 ---
 

content/changelog/2024-01-15-go-sdk-v0.0.8.md → content/changelog/2024/01-15-go-sdk-v0.0.8.md

@@ -13,6 +13,8 @@ authors:
     link: https://github.com/miton18
     image: https://github.com/miton18.png?size=40
 description: The Clever Cloud Go Client has been updated to v0.0.8
+aliases:
+- /changelog/2024-01-15-go-sdk-v0.0.8
 excludeSearch: true
 ---
 

content/changelog/2024-01-22-matomo-5.0.1.md → content/changelog/2024/01-22-matomo-5.0.1.md

@@ -12,10 +12,12 @@ authors:
     link: https://github.com/miton18
     image: https://github.com/miton18.png?size=40
 description: You can now deploy Matomo 5.0.1 on Clever Cloud
+aliases:
+- /changelog/2024-01-22-matomo-5.0.1
 excludeSearch: true
 ---
 
-[Matomo](https://matomo.org/) 5.0 was released mid-December, version 5.0.1 is now available. Since then, we've worked on the support of this new branch on Clever Cloud. It's done! You can deploy this latest version right now from our [Console](https://console.clever-cloud.com) or [Clever Tools](https://github.com/CleverCloud/clever-tools). 
+[Matomo](https://matomo.org/) 5.0 was released mid-December, version 5.0.1 is now available. Since then, we've worked on the support of this new branch on Clever Cloud. It's done! You can deploy this latest version right now from our [Console](https://console.clever-cloud.com) or [Clever Tools](https://github.com/CleverCloud/clever-tools).
 
 Existing customers add-ons are already up-to-date.
 - [Learn more about Matomo 5.0](https://matomo.org/changelog/matomo-5-0-0/)