diff --git a/docs/knowledge_representation.md b/docs/knowledge_representation.md
index 478c107..615115e 100644
--- a/docs/knowledge_representation.md
+++ b/docs/knowledge_representation.md
@@ -3,6 +3,15 @@ title: Knowledge Representation
 layout: default
 nav_order: "70"
 ---
-# Hierarchical Relation
+# Work In Progress
+
+# Knowledge Representation
+
+## Hierarchical Relation
 Information like `apples are fruits` is stored in the knowledge base with `parents` relation between two concepts:
 ![](../assets/images/img1.png)
+
+This relation tells the agent that everything that is known about the concept `Fruit` is also applicable for the concept `Apple`.
+
+
+
diff --git a/docs/world_model.md b/docs/world_model.md
index d50c3ad..10a8693 100644
--- a/docs/world_model.md
+++ b/docs/world_model.md
@@ -6,8 +6,10 @@ nav_order: "50"
 
 # World Model
 
+## Entity
 To effectively process incoming events, generate novel knowledge, and reason about the environment, an agent requires a robust internal representation of the world. Within the present framework, the agent's world model encompasses entities, each resembling a class instance from Object-Oriented Programming (OOP). Each entity comprises a concept and an assortment of fields. The concept defines which fields it can have and their default value if it's predent. For instance, a conceptualization of a human might incorporate fields such as "name", "age", and "gender". Entities don't have to provide values for all fields.  
 
+## Representation
 Entities are represented in the following format:
 ```python
 CID {