mkdocs: format & doc book configuration file

Author: practicalli-johnny

mkdocs.yml

@@ -29,7 +29,7 @@ theme:
     - navigation.indexes # Nav sections can have files
     - navigation.instant # Avoid page reloading for internal links
     - navigation.top
-    - navigation.tracking # Update URL with anchor
+    - navigation.tracking # Update URL with sub-heading anchor names
   palette:
     # Palette toggle for light mode
     - media: "(prefers-color-scheme: light)"
@@ -39,7 +39,6 @@ theme:
       toggle:
         icon: material/brightness-7
         name: Switch to dark mode
-
     # Palette toggle for dark mode
     - media: "(prefers-color-scheme: dark)"
       scheme: slate
@@ -74,7 +73,7 @@ markdown_extensions:
       custom_fences:
         - name: mermaid
           class: mermaid
-          format: !!python/name:pymdownx.superfences.fence_code_format ""
+          format: !!python/name:pymdownx.superfences.fence_code_format
   - pymdownx.tabbed:
       alternate_style: true
   - pymdownx.keys # keyboard keys
@@ -87,25 +86,25 @@ markdown_extensions:
 
 ## Plugins
 plugins:
-  # Explicitly add search plugin when defining plugins to this configuration file
+  # Explicitly add search plugin when defining plugins in this configuration file
   - search
   - callouts
   - glightbox # Image aligning
-  - git-revision-date-localized:
-      # Update and Creation date of each page
+  - git-revision-date-localized: # Update and Creation date of each page
       # enable_creation_date: true
       fallback_to_build_date: true
 
   # Generate Social Cards via CI only
   # in assets/images/social
   - social:
       cards: !ENV [MKDOCS_SOCIAL_CARDS_GENERATE, true]
+
   # Redirect pages when moved or changed
   # - redirects:
   #     redirect_maps:
   #       repl-driven-development.md: introduction/repl-workflow.md
 
-  # Footer / Social Media
+# Footer / Social Media
 extra:
   analytics:
     provider: google