From f504dea98e1fb1d44556d0a5894fcd4394712d2e Mon Sep 17 00:00:00 2001
From: Seyyed Morteza Moosavi <se.mo.moosavi@gmail.com>
Date: Fri, 7 Jan 2022 20:27:41 +0330
Subject: [PATCH] docs(readme): add motivation section

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

diff --git a/README.md b/README.md
index c1497b2..ccf2774 100644
--- a/README.md
+++ b/README.md
@@ -9,6 +9,7 @@ connect react components with wire
 
 <!-- toc -->
 
+- [Motivation](#motivation)
 - [Install](#install)
 - [Usage](#usage)
   - [`useWire` hook](#usewire-hook)
@@ -30,6 +31,17 @@ connect react components with wire
 
 <!-- tocstop -->
 
+## Motivation
+
+- top-level components
+  - doesn't care about the value
+  - care about the connection between components
+- detailed components
+  - only care about the value
+  - doesn't care about where the value came from or will be used
+- controlled/uncontrolled components should be easy to write
+- choosing the correct state location shouldn't be too hard
+
 ## Install
 
 ```bash