Some doc fixes

Author: eadwinCode

docs/index.md

@@ -15,23 +15,29 @@
 Ellar is a lightweight ASGI framework for building efficient and scalable server-side python application.
 It supports both OOP (Object-Oriented Programming) and FP (Functional Programming)
 
-Ellar is built around [Starlette]()(ASGI toolkit) which processes all the HTTP request and background tasks. Although, there is a high level 
+Ellar is built around [Starlette](https://www.starlette.io/)(ASGI toolkit) which processes all the HTTP request and background tasks. Although, there is a high level 
 of abstraction, some concepts of Starlette are still supported.
 
 ## Inspiration
-Ellar was heavily inspired by [NestJS]() in its simplicity in usage while managing complex project structures and application. 
-It also adopted some concepts of [FastAPI]() in handling request parameters and data serialization with pydantic.
+Ellar was heavily inspired by [NestJS](https://docs.nestjs.com/) in its simplicity in usage while managing complex project structures and application. 
+It also adopted some concepts of [FastAPI](https://fastapi.tiangolo.com/) in handling request parameters and data serialization with pydantic.
 With that said, the aim of Ellar focuses on high level of abstraction of framework APIs, project structures, architectures and speed of handling requests.
 
 ## Installation
-To get started, you need to scaffold a project using [Ellar-CLI]() toolkit. This is recommended for first-time user.
+To get started, you need to scaffold a project using [Ellar-CLI](https://eadwincode.github.io/ellar-cli/) toolkit. This is recommended for first-time user.
 The scaffolded project is more like a guide to project setup.
 
 ```shell
 $(venv) pip install ellar[standard]
 $(venv) ellar new project-name
 ```
 
+### NB:
+Some shells may treat square braces (`[` and `]`) as special characters. If that's the case here, then use a quote around the characters to prevent unexpected shell expansion.
+```shell
+pip install "ellar[standard]"
+```
+
 ### Py36 Support
 For python3.6 users, 
 ```shell

mkdocs.yml

@@ -13,15 +13,15 @@ theme:
       primary: pink
       accent: pink
       toggle:
-        icon: material/toggle-switch
+        icon: material/lightbulb
         name: Switch to dark mode
 
     - media: "(prefers-color-scheme: dark)"
       scheme: slate
       primary: pink
       accent: pink
       toggle:
-        icon: material/toggle-switch-off-outline
+        icon: material/lightbulb-outline
         name: Switch to light mode
 
   language: en
@@ -41,9 +41,9 @@ nav:
       - Providers:  overview/providers.md
       - Modules:  overview/modules.md
       - Middlewares:  overview/middleware.md
-      - Exception Filters:  overview/exception-filters.md
+      - Exception Filters:  overview/exception_filters.md
       - Guards:  overview/guards.md
-      - Custom Decorators:  overview/custom-decorators.md
+      - Custom Decorators:  overview/custom_decorators.md
       - How-to Guides:
         - Parsing Request Inputs:
             - Body: overview/how-to-guide/parsing-inputs/body.md
@@ -78,5 +78,7 @@ markdown_extensions:
 - codehilite
 - admonition
 - pymdownx.superfences
+- toc:
+    permalink: true
 extra_css:
   - stylesheets/extra.css