docs(tuto): last fixes

Author: nerda-codes

tutorials/using-bucket-website-with-mkdocs/index.mdx

@@ -13,23 +13,25 @@ dates:
   posted: 2024-10-07
 ---
 
-This tutorial shows you how to create a documentation website using the Scaleway [Object Storage bucket website](/storage/object/concepts/#bucket-website) feature with Material for MkDocs.
+This tutorial shows you how to create a documentation website using the Scaleway [Object Storage bucket website](/storage/object/concepts/#bucket-website) feature with MkDocs.
 
 [MkDocs](https://www.mkdocs.org/) is a static site generator that allows users to generate a static website from a set of Markdown files. It is written in Python and uses Markdown for content creation.
 We will use MkDocs to generate our website, and Material for MkDocs which is a documentation framework that extends MkDocs with additional features and customization options, to create visually appealing and user-friendly documentation websites.
 
+Find out how to Set up MkDocs and configure your website in the first tab, then click the second tab to learn how to get a preview of your website and how to deploy it.
+
 <Macro id="requirements" />
 
 - A Scaleway account logged into the [console](https://console.scaleway.com)
 - [Owner](/identity-and-access-management/iam/concepts/#owner) status or [IAM permissions](/identity-and-access-management/iam/concepts/#permission) allowing you to perform actions in the intended Organization
 - Installed Python
 - Installed pip
-- Installed VS Code
+- Installed Visual Studio Code
 - Knowledge of the [Markdown](https://www.markdownguide.org/getting-started/#what-is-markdown) markup language
 
 <Tabs id="install">
-  <TabsTab label="Setting up MkDocs and configuring your website">
-    1. Open the VS Code terminal and paste the following command to create a virtual environment to host your MkDocs content:
+  <TabsTab label="Set up MkDocs and configure your website">
+    1. Open the Visual Studio Code terminal and paste the following command to create a virtual environment to host your MkDocs content:
         ```
          python -m venv envname
         ```
@@ -174,7 +176,7 @@ We will use MkDocs to generate our website, and Material for MkDocs which is a d
                   name: Switch to light mode
         ```
 
-    ## Configuring fonts
+    ### Configuring fonts
 
         Material for MkDocs integrates with [Google Fonts](https://fonts.google.com/) but you can also add custom fonts if you prefer.
 
@@ -220,7 +222,7 @@ We will use MkDocs to generate our website, and Material for MkDocs which is a d
                 text: Roboto
           ```
 
-    ## Configuring navigation
+    ### Configuring navigation
 
         MkDocs provides multiple ways to configure your website's navigation depending on the amount of content your website contains. Find out [all available configurations for navigation](https://squidfunk.github.io/mkdocs-material/setup/setting-up-navigation/) on the MkDocs website.
 
@@ -237,11 +239,11 @@ We will use MkDocs to generate our website, and Material for MkDocs which is a d
           - How to perform action three: perform-action-three.md
         ```
 
-    ## Configuring admonitions
+    ### Configuring admonitions
 
         You can use admonitions to add side content to your documentation or make parts you want your users to notice stand out more. Refer to the [documentation](https://squidfunk.github.io/mkdocs-material/reference/admonitions/?h=admonitions#admonition-icons) to see available admonition icons.
 
-    ### Enabling admonitions
+    #### Enabling admonitions
 
         Copy and paste the following code template to enable admonitions, make them collapsible, and nest content inside them.
 
@@ -251,7 +253,7 @@ We will use MkDocs to generate our website, and Material for MkDocs which is a d
             - pymdownx.details
             - pymdownx.superfences
           ```
-    ### Adding admonition icons
+    #### Adding admonition icons
 
         Copy and paste the following code template to use Octicons admonition icons. You can also use the [FontAwesome admonition icons](https://squidfunk.github.io/mkdocs-material/reference/admonitions/?h=admonitions#admonition-icons-fontawesome).
 
@@ -272,7 +274,7 @@ We will use MkDocs to generate our website, and Material for MkDocs which is a d
               quote: octicons/quote-16
         ```
 
-    ### Using admonitions
+    #### Using admonitions
 
         The example below shows you the syntax you need to use in your files for admonitions. You can replace `info` with any of the admonitions you have added in the previous section (`abstract`, `note`, `tip`, `success`, `question`, `warning`, `failure`, `danger`, `bug`, `example`, and `quote`).
 
@@ -300,7 +302,7 @@ We will use MkDocs to generate our website, and Material for MkDocs which is a d
 
         Find out more about admonitions on the [MkDocs website](https://squidfunk.github.io/mkdocs-material/reference/admonitions/?h=admonitions#configuration).
 
-    ## Additional configuration
+    ### Additional configuration
 
         You can add the following additional configuration options in your `mkdocs.yml` file. The `features` component allows you to use various features of the Material theme.
           ```
@@ -330,21 +332,21 @@ We will use MkDocs to generate our website, and Material for MkDocs which is a d
           copyright: >
             Copyright &copy; 2016 - 2024 Martin Donath
           ```
-    ## Download the mkdocs file template
+    ## Downloading the mkdocs file template
 
         If you have only added the elements shown in the sections above, you can download the `mkdcos.yml` below.
 
           <a href="/tutorials/using-bucket-website-with-mkdocs/mkdocs-example.yml" target="_blank" rel="noopener noreferrer" download="mkdocs-example.yml"> Download the mkdocs file </a>
 
 </TabsTab>
-  <TabsTab label="Preview your MkDocs website and deploy it">
+  <TabsTab label="Preview and deploy your MkDocs website">
 
       Once your website's content is ready and configured, you can preview it to make sure that everything displays properly.
 
       ## Previewing and generating a static website
 
-      1. Open the folder containing your `docs` directory in VS Code. The one we have created in this tutorial is named `my-folder`.
-      2. Open the VS Code terminal and paste the following command:
+      1. Open the folder containing your `docs` directory in Visual Studio Code. The one we have created in this tutorial is named `my-folder`.
+      2. Open the Visual Studio Code terminal and paste the following command:
           ```
           mkdocs serve
           ```