diff --git a/README.md b/README.md
index ba61eba1..939966d1 100644
--- a/README.md
+++ b/README.md
@@ -1,42 +1,49 @@
+
 # jsBeans - Client-server JavaScript Fullstack Web Framework
-  
+
 ```jsBeans``` — изоморфный клиент-серверный фреймворк класса "full-stack" для создания комплексных программных решений с развитым веб-интерфейсом, объектной иерархией и клиент-серверным взаимодействием.
- 
+
 Реализован на Java 1.8 с Mozilla Rhino в качестве серверного JavaScript движка, встроенным Web сервером на Eclipse Jetty и сервисной шиной на Akka.
- 
-#### Ключевые особенности jsBeans:
- 
-* Веб-интерфейс и бизнес логика приложений разрабатываются на атомарных объектно-ориентированных классах - бинах (```JavaScript Beans (JSB)``` по аналогии с ```JavaBeans```).
-* Дескриптор бина (JSON с функциями) представляет логически законченный функциональный компонент и одновременно содержит как клиентский, так и серверный код.
+
+### Ключевые особенности jsBeans:
+
+* Веб-интерфейс и бизнес логика приложений разрабатываются на атомарных объектно-ориентированных JavaScript-объектах - бинах (```JavaScript Beans (JSB)``` по аналогии с ```JavaBeans```).
+* Бины - логически законченные функциональные компоненты, которые одновременно содержат как клиентский, так и серверный код.
 * Прозрачное взаимодействие клиентской и серверной частей бина и автоматическая синхронизация данных на единой RPC шине.
 * Динамическое разрешение зависимостей бинов.
 * Обмен сообщениями между бинами в едином клиент-серверном пространстве (Actors).
 * Встроенная библиотека клиент-серверных веб-компонентов (JSB.Widgets) и возможность подключения компонентов из репозитория.
 * Возможность использования на серверной стороне любых сторонних Java библиотек.
- 
-#### А также
-* Шаблонизатор ``` `#dot ...` ``` (сейчас ```#dot{{...}}```)
+
+### А также
+* Шаблонизатор ``` `#dot ...` ```
 * Аннотирование полей и методов ```/** @annotation {...} */``` (не реализовано)
-* Публикация методов бина в HTTP API
+* Вызов методов бина через HTTP (http://my.server.com/index.jsb)
 * Расширения бинов (traits), позволяющие навесить на бины дополнительный функционал.
 * Минификатор и упаковщик с управлением зависимостями
 * TODO
 
-#### Использование
- 
+### Использование
+
 1. В виде самостоятельного сервера приложений с развертыванием прикладных приложений "из папки".
 2. В виде подключаемой Java библиотеки. Прикладные модули, как правило, также подключаются в общий classpath основного приложения.
 
 
-## Что такое бины?
-В соответствии с концепцией jsBeans вся логика приложений (как серверная, так и клиентская) строится в виде иерархий объектов на языке JavaScript, напоминающих EJB-компоненты в Java EE. Они изоморфны, соответствуют основным принципам ООП, могут порождаться и удаляться, могут вызываться удаленно и мигрировать с одного сервера на другой или в браузер. Такие объекты мы называем - **бинами**.
 
-#### Простейший бин
-Бины описываются в виде JSON объектов. Они содержат системные поля, отражающие специфику функционирования бина, а также ряд пользовательских полей и методов для описания бизнес логики.
-Все системные поля начинаются на $, например ```$name```, ```$parent```, ```$require``` и т.п.
 
-Декларация бина осуществляется с помощью функции ```JSB(beanDeclarationJson);``` и выглядит следующим образом:
 
+
+
+## Основные принципы
+
+### Что такое бины?
+В соответствии с концепцией jsBeans вся логика приложений (как серверная, так и клиентская) строится в виде иерархий объектов на языке JavaScript, напоминающих EJB-компоненты в Java EE. Они изоморфны, соответствуют основным принципам ООП, могут порождаться и удаляться, могут вызываться удаленно и мигрировать с одного сервера на другой или в браузер. Такие объекты мы называем - **бинами**.
+
+Бины описываются в виде JS объектов. Они содержат системные поля, отражающие специфику функционирования бина, а также ряд пользовательских полей и методов для описания бизнес логики.
+Все системные поля начинаются на ```$```, например: 
+```$name``` ,  ```$parent``` , ```$require``` и т.п.
+
+Декларация бина осуществляется с помощью функции ```JSB(beanDescriptor);``` и выглядит следующим образом:
 ```javascript
 JSB({
     $name: 'MyBean',
@@ -49,9 +56,9 @@ JSB({
 });
 ```
 
-Функция ```JSB(beanDeclarationJson)``` непосредственно формирует сам бин по описанию в ```beanDeclarationJson``` и помещает его в специальный контейнер бинов (JSB-контейнер) с целью дальнейшего управления его жизненным циклом. JSB-контейнер изоморфен и присутствует как на стороне сервера так и на стороне клиента.
+Функция ```JSB(beanDescriptor)``` непосредственно формирует сам бин по описанию в ```beanDescriptor``` и помещает его в специальный контейнер бинов (JSB-контейнер) с целью дальнейшего управления его жизненным циклом. JSB-контейнер изоморфен и присутствует как на стороне сервера так и на стороне клиента.
 
-Таким образом вышеприведенный бин может быть одинаково использован как стороне сервера, так и на стороне клиента(ов).
+Таким образом вышеприведенный бин может быть одинаково использован как стороне сервера, так и в браузере.
 
 ```javascript
 JSB.lookup('MyBean', function(MyBeanClass){
@@ -59,16 +66,32 @@ JSB.lookup('MyBean', function(MyBeanClass){
 	myBeanInst.myMethod();
 });
 ```
+Все бины размещаются в файлах ```*.jsb``` в файловой системе сервера. В момент инициализации сервер рекурсивно сканирует папку с бинами и загружает их в свой репозиторий.
+Каждый файл ```*.jsb``` содержит только декларацию бина без функции ```JSB(...)```, например:
+Файл ```test.jsb```:
+```javascript
+{
+    $name: 'MyBean',
+    
+    myField: 123,
+    
+    myMethod: function(){
+        return this.myField;
+    }    
+}
+```
+### Контейнер бинов
+Ключевую роль в jsBeans играет JSB-контейнер, который отвечает за жизненный цикл бинов, разрешение зависимостей между ними, обеспечение клиент-серверного взаимодействия и синхронизацию полей у экземпляров бинов на клиентской и серверной сторонах.
 
-#### Клиент-серверный бин
+### Клиент-серверное взаимодействие
 Клиент-серверные бины, как правило, содержат несколько секций (в частности – ```$server``` и ```$client```).
 
 В секции ```$client```, в основном, располагаются поля и методы для взаимодействия с DOM моделью браузера, а в секции ```$server``` – серверные поля и методы, отвечающие за бизнес логику, работу с СУБД, файловой системой и другими ресурсами операционной системы.
 В общем случае при создании экземпляра бина на стороне клиента создается соответствующий ему серверный экземпляр и между ними устанавливается взаимодействие, характер которого (один к одному / много к одному) задается разработчиком при декларации бина.
 Взаимодействие между кодом из разных секций осуществляется прозрачно для разработчика, путем вызова автоматически генерируемых асинхронных proxy методов.
-
+Файл ```mybean.jsb```:
 ```javascript
-JSB({
+{
     /** пакет и имя бина */
     $name: 'my.examples.MyBean',
     
@@ -97,14 +120,17 @@ JSB({
 		scheduleTimestampMessage: function(){
 			window.setInterval(function(){
                 /** вызов метода из "противоположной секции" осуществляется 
-                асинхронно через адаптер, получаемый внутри методов $server() 
-                и вне jsb.$server()*/
-                $server().getTimestamp(function(result, error){                    
-                    /** в scope всех методов добавляется $this равный this 
-                    метода бина, чтобы перед вложенными функциями не декларировать '
-                    var self = this' */
+                асинхронно через адаптер, получаемый путем вызова метода remote() 
+                у бина.
+                */
+                $this.remote().getTimestamp(function(result, error){                    					/** результат вызова удаленного метода будет возвращен в коллбэк */
+                    
+                    /** в scope всех методов автоматически добавляется 
+                    	локальная переменная $this равный this метода бина, 
+                    	чтобы перед вложенными функциями не декларировать: 
+                    	var self = this; */
                     if (!error) {
-                        let data = {timestamp: 0 + result};
+                        var data = {timestamp: 0 + result};
                         alert($this.formatMessageText(data));
                     }
                 });                
@@ -114,31 +140,36 @@ JSB({
 
     /** секция серверного кода (исполняется на сервере)*/
     $server: {
+        /** при необходимости могут быть задействованы классы и методы из Java*/
+        $require: {System:'java:java.lang.System'},
+            
         /** серверный конструктор вызывается при порождении серверной части 
-        экземпляра бина */
+        	экземпляра бина */
         $constructor: function(){
             /** создание экземпляра импортированного бина */
             this.myWorld = new MyWorld();                        
         },
         
         /** методы, объявленные в серверной секции могут вызываться с клиента 
-        и наоборот */
+        	и наоборот */
         getTimestamp: function (){
             return 0 + this.getSystemTimestamp();
         },
         
-        /** В серверной секции так же можно использовать java классы и объекты, 
-        добавив префикс 'Packages.' */
         getSystemTimestamp: function() {
-            return Packages.java.lang.System.currentTimeMillis();
+            /** Вызываем метод класса Java из пакета java.lang.System для получения
+             	текущего времени */
+            return System.currentTimeMillis();
         }
     }    
-});
+}
 ```
 
-#### Web компонент
+## Создание web компонентов
+### Web компонент
+Файл ```myWebControl.jsb```:
 ```javascript
-JSB({
+{
 	$name: 'my.examples.MyWebControl',
 
 	/** Унаследуем наш компонент от бина Control из библиотеки JSB.Widgets */
@@ -149,12 +180,12 @@ JSB({
 
 	/** Клиентская секция (код будет выполняться в браузере) */
 	$client: {
-		#constructor: function(opts){
+		$constructor: function(opts){
 			$base(opts); // Вызываем родительский конструктор
 			
 			/** Загружаем стили (путь задается относительно места расположения 
 			файла с текущим бином) */
-			this.loadCss('myWebControl.css');
+			$jsb.loadCss('myWebControl.css');
 
 			/** Создадим экземпляр бина ComboBox из библиотеки JSB.Widgets */
 			var cb = new ComboBox({
@@ -198,9 +229,17 @@ JSB({
 			Первым аргументом передаем значение из комбо, а вторым - колбэк 
 			функцию, которая будет вызвана сразу как только серверный метод 
 			вернет данные */
-			$server().loadMyData(cbVal, function(res){
+			this.server().loadMyData(cbVal, function(res){
 				$this.drawData(res); // отрисуем данные
 			});
+            /** Для удаленного вызова серверного кода можно также использовать
+            	функцию remote(), которая осуществляет удаленный вызов на 
+            	противоположной стороне. Но если мы знаем, что вызывающий метод
+                находится на стороне клиента и удаленно вызывает серверную
+                функцию, то можно явно сразу использовать метод server().
+                Аналогична и обратная ситуация - находясь в теле серверного метода
+                можно удаленно вызвать клиентский метод, путем использования
+                функции client()*/
 		},
 		
 		drawData: function(data){
@@ -231,14 +270,14 @@ JSB({
 			return this.myDictionary[key];
 		}
 	}
-});
+}
 ```
 
-####  Встраивание компонента в HTML при помощи JavaScript
+###  Встраивание компонента в HTML при помощи JavaScript
 ```html
 <html>
 	<head>
-		<script type="text/javascript" src="jsbeans.js"></script>
+		<script type="text/javascript" src="jsbeans.jsb"></script>
 	</head>
 	<body>
 		<div id="myGlobalContainer"></div>
@@ -256,11 +295,11 @@ JSB({
 </html>
 ```
 
-#### Автоматическое встраивание компонента в HTML
+### Автоматическое встраивание компонента в HTML
 ```html
 <html>
 	<head>
-		<script type="text/javascript" src="jsbeans.js"></script>
+		<script type="text/javascript" src="jsbeans.jsb"></script>
 	</head>
 	<body>
 		<div id="myGlobalContainer" 
@@ -275,11 +314,11 @@ JSB({
 Поля и методы, объявленные в общей секции бина (вне ```$server``` и ```$client```) являются общими и для сервера и для клиента и могут использоваться в коде обеих секций. JsBeans позволяет синхронизировать общие поля таким образом, что поле измененное кодом на одной стороне автоматически обновится и на другой. 
 Политика синхронизации полей гибко настраивается опцией ```$sync```, которая может задаваться в разных секциях бина. Синхронизация может быть однонаправленной и двунаправленной, может осуществляться автоматически, а может управляться программно.
 
-#### Автоматическая однонаправленная синхронизация
-Для включения автоматической однонаправленной синхронизации необходимо в общей секции бина установить опцию ```$sync: true```. В этом случае все общие поля, изменяемые кодом на стороне сервера, будут автоматически изменяться на стороне клиента, **но не наоборот**.
+### Автоматическая однонаправленная синхронизация
+Для включения автоматической однонаправленной синхронизации необходимо в общей секции бина установить опцию ```$sync: true```. В этом случае все общие поля, изменяемые кодом на стороне сервера, будут автоматически изменяться и на стороне клиента, **но не наоборот**.
 
 ```javascript
-JSB({
+{
 	$name: 'my.examples.MySyncBean',
 	$sync: true,
 
@@ -306,12 +345,12 @@ JSB({
 			}, 60000);
 		}
 	}
-});
+}
 ```
 
 После создания экземпляра бина на стороне клиента, на серверной стороне будет автоматически создана его серверная часть и вызовется конструктор. Далее серверный конструктор вызывает системную функцию ```JSB.interval```, которая установит интервал обновления поля на стороне сервера в одну минуту. В результате, в консоли клиента каждую минуту будет печататься текущее время.
 
-#### Настройка политики синхронизации
+### Настройка политики синхронизации
 Опция ```$sync:true``` устанавливает политику синхронизации по умолчанию, которая эквивалентна следующей настройке:
 
 ```javascript
@@ -326,10 +365,10 @@ $sync: {
 
 Установка значений для ```updateClient``` и ```updateServer``` позволяет задать направление синхронизации, при этом синхронизация может быть как однонаправленной, так и двунаправленной (оба значения установлены в ```true```).
 При помощи опций ```include``` и ```exclude``` можно указать имена полей, подлежащих синхронизации.
-Опция ```updateCheckInterval``` позволяет установить интервал проверки полей на необходимость их синхронизации. Надо отметить, что в случае большого количества синхронизируемых полей, автоматическая проверка может негативно сказываться на производительности. В таких случаях рекомендуется выполнять проверку изменений только по мере необходимости и желательно в тех местах, где эти изменения происходят. Для этого нужно отключить автоматическую проверку, установив опцию ```updateCheckInterval: 0``` и запускать эту процедуру программно, при помощи вызова метода ```$doSync```, который имеется у каждого бина.
+Опция ```updateCheckInterval``` позволяет установить интервал проверки полей на необходимость их синхронизации. Надо отметить, что в случае большого количества синхронизируемых полей, автоматическая проверка может негативно сказываться на производительности. В таких случаях рекомендуется выполнять проверку изменений только по мере необходимости и желательно в тех местах, где эти изменения происходят. Для этого нужно отключить автоматическую проверку, установив опцию ```updateCheckInterval: 0``` и запускать эту процедуру программно, при помощи вызова метода ```doSync```, который имеется у каждого бина.
 
 ```javascript
-JSB({
+{
 	$name: 'my.examples.MySyncBean2',
 	$sync: {
 		updateCheckInterval: 0 // отключим автоматическую синхронизацию
@@ -343,9 +382,9 @@ JSB({
 			console.log(this.myCommonField);
 		},
 		
-		/** Метод $onSyncAfter будет вызван сразу как только одно или несколько
+		/** Метод onAfterSync будет вызван сразу как только одно или несколько
 		синхронизируемых полей будут обновлены */
-		$onSyncAfter: function(syncInfo){
+		onAfterSync: function(syncInfo){
 			console.log(this.myCommonField);
 		}
 	},
@@ -356,18 +395,18 @@ JSB({
 			JSB.interval(function(){
 				$this.myCommonField = new Date().toString();
 
-				/** Вызовем процедуру синхронизации */
-				$this.$doSync();
+				/** Вызовем процедуру синхронизации программно*/
+				$this.doSync();
 			}, 60000);
 		}
 	}
-});
+}
 ```
-#### Управление логикой синхронизации
-При изменении общих полей на одной стороне, ```jsBeans``` обнаруживает эти изменения и формирует так называемый синхропакет, который впоследствии передается на другую сторону и используется для обновления полей. Перед непосредственным обновлением, синхропакет проходит через метод ```$onBeforeSync```, который есть у каждого бина. Переопределение этого метода позволит разработчику принимать решения об обновлении полей, предварительно проанализировав синхропакет.
+### Управление логикой синхронизации
+При изменении общих полей на одной стороне, ```jsBeans``` обнаруживает эти изменения и формирует так называемый синхропакет, который впоследствии передается на другую сторону и используется для обновления полей. Перед непосредственным обновлением, синхропакет проходит через метод ```onBeforeSync```, который есть у каждого бина. Переопределение этого метода позволит разработчику принимать решения об обновлении полей, предварительно проанализировав синхропакет.
 
 ```javascript
-JSB({
+{
 	$name: 'my.examples.SyncBeforeAfterTest'
 
 	myField1: 'test',
@@ -375,10 +414,10 @@ JSB({
 
 	$client: {
 		// ...
-		/** $onBeforeSync вызывается после получения синхропакета, 
+		/** onBeforeSync вызывается после получения синхропакета, 
 		но перед обновлением полей. 
 		Здесь мы можем принять решение - стоит	ли применять синхропакет или нет */
-		$onBeforeSync: function(syncInfo){
+		onBeforeSync: function(syncInfo){
 			if(syncInfo.isChanged('myField1')) {
 				return false; // не будем принимать изменения
 			}
@@ -386,13 +425,13 @@ JSB({
 		}
 		// ...
 	}
-});
+}
 ```
 
-После обновления полей фреймворк вызывает метод ```$onAfterSync``` в целях уведомления о произведенной синхронизации.
+После обновления полей фреймворк вызывает метод ```onAfterSync``` в целях уведомления о произведенной синхронизации.
 
 ```javascript
-JSB({
+{
 	$name: 'my.examples.SyncBeforeAfterTest2'
 
 	myField1: 'test',
@@ -400,16 +439,16 @@ JSB({
 
 	$client: {
 		// ...
-		/** $onAfterSync вызывается после синхронизации.
+		/** onAfterSync вызывается после синхронизации.
 		Здесь мы можем выполнить какие-либо действия узнав, что поле обновилось*/
-		$onAfterSync: function(syncInfo){
+		onAfterSync: function(syncInfo){
 			if(syncInfo.isChanged('myField1')) {
 				console.log('Ура, теперь myField1 = ' + $this.myField1);
 			}
 		}
 		// ...
 	}
-});
+}
 ```
 
 
@@ -419,23 +458,23 @@ JSB({
 ## Управление жизненным циклом
 Бин является составным объектом, разные его части (клиентская и серверная) имеют различные JavaScript объекты, у каждого может быть свой жизненный цикл и область видимости. Разработчик может привязать жизненный цикл бина к сесии пользователя, управлять автопорождением экземпляров или управлять жизненным циклом вручную. Ниже приведено несколько часто используемых случаев. 
 
-#### Синглтон 
+### Синглтон 
 * TODO
 
-#### Синглтон в рамках сессии
+### Синглтон в рамках сессии
 * TODO
 
-#### Автопорождение серверной части с клиента
+### Автопорождение серверной части с клиента
 * TODO
 
-#### Один бин: один клиентский - один серверный
+### Один бин: один клиентский - один серверный
 * TODO
 
-#### Один бин: много клиентских - один серверный
+### Один бин: много клиентских - один серверный
 * TODO
 
-#### Один бин: много клиентских - много серверных
+### Один бин: много клиентских - много серверных
 * TODO
 
-
-  
\ No newline at end of file
+#
+.