From 372f1624f3c734767a38f85d4791e336bbc5487c Mon Sep 17 00:00:00 2001
From: Charles Iliya Krempeaux <iamreiver@gmail.com>
Date: Thu, 16 Nov 2023 05:01:12 -0800
Subject: [PATCH] README.md

---
 README.md | 14 ++++++++++++--
 1 file changed, 12 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index 0b49059..b40fdbf 100644
--- a/README.md
+++ b/README.md
@@ -1,12 +1,20 @@
 # asan.js
 
-**asan.js** is a **convention-over-configuration** model-view system for web-sites and web-applications.
+**asan.js** is a **convention-over-configuration** style **model-view** system for web-sites and web-applications.
 
-The attaction of using **asan** is that the location of the **model** for a path is very straight-forward
+The attaction of using **asan** is that the location of the **model** for a path is very straight-forward.
 
 For example, the **model** for a path "`/an/example/path`" would be at "`/src/an/example/path`".
 I.e., a "`/src`" prefix is added to the current path to get the **model**.
 
+Since **asan** is **convention-over-configuration**, it takes care of all this for you.
+**asan** infers what the current path is.
+(Ex: "`/apple/banana/cherry.html`".)
+And then **asan** calculates the path of the **model** (based of the current path).
+(Ex: "`/src/apple/banana/cherry.html`".)
+And then includes that.
+You just have to tel it _where_ to include it.
+
 ## Example
 
 Here is an example usage of **asan.js**:
@@ -19,6 +27,8 @@ Here is an example usage of **asan.js**:
 		<script type="module">
 		import * as asan from "./asan.js" // <--- Your path of asan.js might be different.
 
+		// In this example code, we are going to tell asan to include the view under the element with id="main".
+		// In your code you could do something else.
 		const element = document.getElementById("main")
 
 		asan.include(element)