diff --git a/pages/mdbook.yml b/pages/mdbook.yml
index b4f0585..ddff0de 100644
--- a/pages/mdbook.yml
+++ b/pages/mdbook.yml
@@ -22,34 +22,31 @@ permissions:
 concurrency:
   group: "pages"
   cancel-in-progress: true
+
 jobs:
-  # This workflow contains a single job called "build"
+  # Build job
   build:
-    env:
-      MDBOOK_VERSION : 0.4.21
-    # The type of runner that the job will run on
     runs-on: ubuntu-latest
-
-    # Steps represent a sequence of tasks that will be executed as part of the job
+    env:
+      MDBOOK_VERSION: 0.4.21
     steps:
-      # Checks-out your repository under $GITHUB_WORKSPACE, so your job can access it
       - uses: actions/checkout@v3
-
-      # Runs a single command using the runners shell
-      - name: install mdbook
+      - name: Install mdBook
         run: |
           curl --proto '=https' --tlsv1.2 https://sh.rustup.rs -sSf -y | sh
           rustup update
           cargo install --version ${MDBOOK_VERSION} mdbook
       - name: Setup Pages
         id: pages
-        uses: actions/configure-pages@v1
-      - name: Build with mdbook
+        uses: actions/configure-pages@v3
+      - name: Build with mdBook
         run: mdbook build
       - name: Upload artifact
         uses: actions/upload-pages-artifact@v1
         with:
           path: ./book
+
+  # Deployment job
   deploy:
     environment:
       name: github-pages