diff --git a/docs/comparing.md b/docs/comparing.md
new file mode 100644
index 0000000..0e5797b
--- /dev/null
+++ b/docs/comparing.md
@@ -0,0 +1,51 @@
+## Events
+
+* `addEventHandler` replaced with decorator [event](events/event.md)
+```python
+@g2o.event('onInit')
+def evtInitFirst(**kwargs):
+    print('Hello')
+    
+@g2o.event('onInit', 100)       # '100' is priority
+def evtInitSecond(**kwargs):
+    print('World')
+```
+---
+* Positional arguments replaced with keyword arguments (see names of all keywords on the each event page)
+```python
+@g2o.event('onPlayerChangeColor')
+def evtColor(**kwargs):
+    playerid = kwargs['playerid']
+    r = kwargs['r']
+    b = kwargs['b']
+```
+---
+* `callEvent` now also requires to pass keyword arguments instead of positional arguments
+```python
+@g2o.event('MyTestEvent')
+def testEvt(**kwargs):
+    print(kwargs)
+    
+g2o.callEvent('MyTestEvent', name = 'aurumvorax', 'id' = 15)
+# OR
+g2o.callEvent('MyTestEvent', {name: 'aurumvorax', 'id': 15})
+# OR
+args = {name: 'aurumvorax', 'id': 15}
+g2o.callEvent('MyTestEvent', args)
+```
+---
+* `cancelEvent` replaced with returning `False` inside the handler
+<sup>*(you don't need to explicitly return `True` if you don't want to cancel the event)*</sup>
+```python
+@g2o.event('onPlayerTakeItem')
+def evtTake(**kwargs):
+    return False
+```
+---
+* `isEventCancelled` replaced with built-in function property `cancelled`, alongside with the `eventName` (if you need it for some reason)
+```python
+@g2o.event('onPlayerDropItem')
+def evtDrop(**kwargs):
+    print(evtDrop.cancelled)
+    print(evtDrop.eventName)
+```
\ No newline at end of file
diff --git a/mkdocs.yml b/mkdocs.yml
index 407004f..c63086a 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -16,6 +16,7 @@ repo_url: https://github.com/AURUMVORXX/PyG2O.git
   
 nav:
   - How to use: index.md
+  - Comparing with Squirrel: comparing.md
   - QnA: qna.md
   - Classes:
     - Game: