reviewed in full

_includes/findAll.html

@@ -1,9 +1,13 @@
 <div class="shell">
   {% highlight st %}
-"Get all models of a given Mapless class from the repository"
+  "Get all models of a given Mapless class from the repository"
     allTasks := repository findAll: Task.
 
-    "Same but when your Mapless class can do its own getRepository"
+    "Same within the repository context"
+    repository do: [ allTasks := Task findAll ].
+
+    "Same but when your Mapless class can do its own getRepository
+    (uses the MaplessCurrentRepository DynamicVariable)"
     allTasks := Task findAll.
 
     "Getting a specific model using its id"
@@ -22,8 +26,11 @@
       offset: 20
       sort: { #description -> 1 } asDictionary.   
 
-    "Same query but with a PostgreSQL backend instead"
+    "If we'd be using PostgreSQL instead and wanting the same data"
     criteria := 'maplessData->> ''description'' LIKE ''Try%'''.
+
+    "The criteria filter here is used in the predicate of the SQL sentence 
+    that Mapless creates for querying this"
     userTasksAboutTryingThings := Task find: criteria
       limit: 10
       offset: 20

_includes/intention.html

@@ -4,7 +4,7 @@
 	        <h5 class="h5NoTop">Why Mapless?</h5>
 	        <div class="thumb">
 	            <a href="https://sebastiansastre.co/" target="_blank" >
-								<img alt="Sebastian Sastre portrait" src="images/p3.jpg" width="68">
+								<img alt="Sebastian Sastre portrait" src="images/seb.jpeg" width="68">
 	            </a>
 	        </div>
 

_includes/intro.html

@@ -4,21 +4,21 @@ <h2 class="catchPhrase"><em>Obscenely</em> simple object persistence</h2>
 		<div class="col-md-4">
 			<div class="appeal leftAppeal">
 			    <h3>Simple</h3>
-			    <p>Low maintenance for real. No instVars. No getters and no setters - just saved models with your data.</p>
+			    <p>Low maintenance for real. No instance variables, no getters, and no setters — just saved models with your data.</p>
 			    <a href="#updating">Add data to a model →</a>
 			</div>
 		</div>
 		<div class="col-md-4">
 			<div class="appeal middleAppeal">
 			    <h3>Composable</h3>
-			    <p>Do you need to compose models? But of course you do! No mapping required, just add those (sub)models, save its children first and you're good to go.</p>
+					<p>Do you need to compose models? But of course you do! No mapping required — just add those (sub)models, save its children first, and you're good to go.</p>
 			    <a href="#composability">Compose models →</a>
 			</div>
 		</div>
 		<div class="col-md-4">
 			<div class="appeal rightAppeal">
 			    <h3>Portable</h3>
-			    <p>Shared API across backends. i.e.: start with SQLite and easily move to MongoDB or PostgreSQL while caching with Redis.</p>
+					<p>Shared API across backends. For example, start with SQLite and easily move to MongoDB or PostgreSQL while caching with Redis.</p>
 			    <a href="#portability">Data portability →</a>
 			</div>
 		</div>

_includes/navigation.html

@@ -4,6 +4,8 @@
 repository do: [ task alert class = MaplessReference ].
 "=> true"
 
+"At this point, Mapless never queried to fetch the data that belongs to the alert of that task..."
+
 "Alert as (sub)model in task, is lazily fetched with the first message 
 and responding as if always would have been ready"
 repository do: [ task alert message ].

_includes/repository.html

@@ -1,7 +1,7 @@
 <div class="shell">
   {% highlight st %} 
   "Create the repository object to use the 'TryingMapless' database.
-  This repository is for a local standalone MongoDB at localhost:27017" 
+  This repository is for a standalone MongoDB listening on localhost:27017" 
   databaseName := 'TryingMapless'. 
   repository := MaplessMongoRepository 
     for: databaseName