Apply suggestions from code review

Co-authored-by: Benedikt Rollik <[email protected]>

Author: thomas-tacquet

tutorials/deploy-mdbooks-serverless-containers/index.mdx

@@ -1,10 +1,10 @@
 ---
 meta:
   title: Fast deployment of documentation on Serverless Containers with mdbooks
-  description: Step-by-step guide to deploy mdbooks on Serverless Containers.
+  description: Step-by-step guide to deploy mdbooks on Scaleway Serverless Containers.
 content:
-  h1: Deploying mdbooks on Serverless Containers
-  paragraph:
+  h1: Fast deployment of documentation on Serverless Containers with mdbooks
+  paragraph: Step-by-step guide to deploy mdbooks on Scaleway Serverless Containers.
 tags: docker container deploy serverless
 hero: assets/scaleway-umami.webp
 categories:
@@ -17,7 +17,7 @@ dates:
 
 Publish modern online books, for product, API documentation, tutorials, course material or anything that requires a clean, easily navigable and customizable presentation.
 
-**Goal** this tutorial uses `mdbooks` to publish simple documentation but the main goal of this tutorial is to show how simple it is to
+This tutorial uses `mdbooks` to publish simple documentation but the main goal of this tutorial is to show how simple it is to
 pick a project, package it inside an image and deploy it on Serverless Containers.
 
 <Macro id="requirements" />
@@ -28,21 +28,21 @@ pick a project, package it inside an image and deploy it on Serverless Container
 
 ## Why deploying on Serverless
 
-Serverless products are perfect for cost efficiency with a pay-as-you go model and scales very well.
+Serverless products are perfect for cost efficiency with a pay-as-you-go model and scale very well.
 
-With zero infrastructure management a lot of tools to integrate in CI/CD environments, `mdbooks` can benefits a lot of Serverless Containers.
+With zero infrastructure management and many tools to integrate in CI/CD environments, `mdbooks` can benefit a lot of Serverless Containers.
 
 ## Local setup
 
-1. Follow [Istallation instructions](https://rust-lang.github.io/mdBook/guide/installation.html) of mdbooks.
+1. Follow the [installation instructions](https://rust-lang.github.io/mdBook/guide/installation.html) of mdbooks.
 
 2. Run commands:
 - `mdbook init my-first-book` in order to create a sample book.
 - `cd my-first-book` to open the directory created by init command.
 
 3. *(optional)* Now you can edit the content of the book to publish.
 
-4. It's recommanded to test the book using the command: `mdbook test`.
+4. It is recommended to test the book using the command: `mdbook test`.
 
 ## Prepare Container Registry
 
@@ -73,7 +73,7 @@ ENV PATH="$PATH:/home/mdbooks"
 ENTRYPOINT ["mdbook", "serve", "-n", "0.0.0.0", "-p", "8080" ]
 ```
 
-2. Open Container Registry product on Scaleway Console.
+2. Open a web browser on your computer and navigate to the [Container Registry](https://console.scaleway.com/containers/) product in the Scaleway Console.
 3. Click **Create namespace**. A namespace is used to hold the image.
 
 <Message type="note">
@@ -82,7 +82,10 @@ ENTRYPOINT ["mdbook", "serve", "-n", "0.0.0.0", "-p", "8080" ]
 
 4. Create the namespace and save the registry endpoint. The registry endpoint looks like `rg.<region>.scw.cloud/<namespace>`
 
-## Build and Push
+<Message type="note">
+  Refer to [How to create a namespace](/docs/containers/container-registry/how-to/create-namespace/) for detailed information about Container Registry namespace creation.
+</Message>
+## Build and push
 
 1. Run the command `docker build -t rg.<region>.scw.cloud/<namespace>/<image_name>:<tag_name> .`
 * **region**: to get this information, check the namespace settings of the namespace you created.
@@ -94,7 +97,7 @@ ENTRYPOINT ["mdbook", "serve", "-n", "0.0.0.0", "-p", "8080" ]
 
 ## Deploy the Serverless Container
 
-1. Create a Serverless Container Namespace. [Link to console](https://console.scaleway.com/containers/namespaces/create)
+1. Create a [Serverless Container Namespace](https://console.scaleway.com/containers/namespaces/create) in the Scaleway console.
 2. Configure the Serverless Containers. **Important points are:**
 * **Image**: Select the Registry namespace, Container and Tag you created before using the dropdown lists.
 * **Name**: You can change the default name to use a more meaningful one.