From 55e954b68244f0f2840c8a068f36e9a5353a45db Mon Sep 17 00:00:00 2001
From: Alexander Makarov <sam@rmcreative.ru>
Date: Fri, 29 Nov 2013 03:31:19 +0400
Subject: [PATCH] Docs on using behaviors

---
 docs/guide/behaviors.md | 39 ++++++++++++++++++++++++++++++++++++++-
 1 file changed, 38 insertions(+), 1 deletion(-)

diff --git a/docs/guide/behaviors.md b/docs/guide/behaviors.md
index 8a67270..b425fd3 100644
--- a/docs/guide/behaviors.md
+++ b/docs/guide/behaviors.md
@@ -1,4 +1,41 @@
 Behaviors
 =========
 
-TDB
\ No newline at end of file
+A behavior (also knows as mixin) can be used to enhance the functionality of an existing component without modifying its
+code. In particular, it can "inject" its own methods and properties into the component and make them directly accessible
+via the component. It can also respond to the events triggered in the component and thus intercept the normal
+code execution. Unlike PHP traits, behaviors could be attached to classes at runtime.
+
+Using behaviors
+---------------
+
+Behavior can be attached to any class that extends from `Component`. In order to do so you need to implement `behaviors`
+method. Yii provides `AutoTimestamp` behavior that handles updating timestamp fields on saving active record model.
+
+```php
+class User extends ActiveRecord
+{
+	// ...
+
+	public function behaviors()
+	{
+		return [
+			'timestamp' => [
+				'class' => 'yii\behaviors\AutoTimestamp',
+				'attributes' => [
+					ActiveRecord::EVENT_BEFORE_INSERT => ['create_time', 'update_time'],
+					ActiveRecord::EVENT_BEFORE_UPDATE => 'update_time',
+				],
+			],
+		];
+	}
+}
+```
+
+In the above `class` value is a string containing fully qualified behavior class name. All the other key-values are
+assigned to corresponding properties of the class.
+
+Creating your own behaviors
+---------------------------
+
+TBD
\ No newline at end of file