diff --git a/README.md b/README.md
index 1760fa0..0591765 100644
--- a/README.md
+++ b/README.md
@@ -6,4 +6,6 @@ Structure:
 Index.php is the entry point. From here tasks are deferred to the HUtils controller class to get the right model.
 Database stuff is done in the Database controller class.
 Session token stuff is done in the UserSession class.
-Assethandler returns <img> html blocks
+Assethandler returns img html blocks.
+
+The UserSession class keeps track of the user signin state using cookie based tokens