feat(docs): general improvements

deno.json

@@ -14,4 +14,4 @@
     "fmt": {
         "indentWidth": 4
     }
-}
+}

docs/custom-parsers.md

@@ -10,12 +10,15 @@ will contain your parsers.
 
 <!-- deno-fmt-ignore -->
 ```yaml title=".../cela/config.yml" linenums="1"
-parsers_dir: ... # /home/Documents/parsers
+parsers_dir: ... # (1)
 ```
 
+1. For example, `/home/myxi/Documents/parsers`
+
 <!-- deno-fmt-ignore -->
-!!! note
-    Please use absolute paths instead of relative ones.
+!!! warning
+    Please use absolute paths instead of relative ones. Cela does not handle relative
+    paths.
 
 Next up, create a sub-directory in the configured directory (`parsers_dir`).
 Whatever you name it will be considered as the parser's id. For my example I
@@ -61,7 +64,7 @@ In your parser's directory you need to have a source tree like this:
 <!-- deno-fmt-ignore-start-->
 To complete the example I will include the example script files for `deno`.
 === "fetcher.py"
-    ```py
+    ```py linenums="1"
     import json
     import os
     import sys
@@ -75,7 +78,7 @@ To complete the example I will include the example script files for `deno`.
         main()
     ```
 === "updater.py"
-    ```py
+    ```py linenums="1"
     import json
     import os
 
@@ -152,8 +155,8 @@ fetcher's script.
 
 ## Debugging
 
-You can see the outputs of your scripts when running with `cela` by using
-`--debug` option to enable debug logs of `cela`.
+You can see the outputs of your scripts when running with Cela by using
+`--debug` option to enable debug logs of Cela.
 
 ## Exit Codes
 

docs/index.md

@@ -3,7 +3,7 @@
 This tool helps you increment/decrement semantic versions in files using custom
 scripts and ergonomic shell commands.
 
-# How To Use
+## How to Use
 
 <!-- deno-fmt-ignore -->
 !!! tip
@@ -33,7 +33,7 @@ You can then provide the parser id (the folder name under
 [`parsers_dir`](/custom-parsers/#custom-parsers) directory) as an argument.
 E.g., `cela -MMp deno` would call the `deno` parser to update the version.
 
-## Examples
+### Examples
 
 <!-- deno-fmt-ignore -->
 !!! example
@@ -71,6 +71,6 @@ E.g., `cela -MMp deno` would call the `deno` parser to update the version.
     [INFO] Updated version from 1.2.1 to 0.1.0 (custom).
     ```
 
-# Custom Parsers
+## Custom Parsers
 
 See [Custom Parsers](/custom-parsers).

mkdocs.yml

@@ -20,6 +20,10 @@ theme:
           toggle:
               icon: material/brightness-7
               name: Switch to dark mode
+    features:
+        - content.code.copy
+        - content.code.select
+        - content.code.annotate
 extra_css:
     - css/extra.css