chore: cleanup

- rst heading definitions
- indirect hyperlinks and code-blocks added for better readability
- MarkDown warnings resolved
- Yaml style issues fixed

.github/workflows/shellcheck.yml

@@ -9,7 +9,7 @@ on:
   pull_request:
   push:
     branches:
-    - master
+      - master
 
 permissions:
   contents: read