diff --git a/README.md b/README.md
index d4bbc7d..88402d6 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,6 @@
-## Files and sample code for Java Swing: Effective User Interfaces book (Russian, 2011).
-All chapters are invidual subprojects with no packages for quicker run - just run `java SampleCode`.
+## Исходный код примеров из книги Java Swing: Эффектные пользовательские интерфейсы - Издание второе (Russian, 2011).
+Код представляет собой набор директорий с примерами для каждой главы. Отдельной директорией идет директория `tools`, в которой хранятся полезные инструменты и заготовки из пакета `com.porty.swing`, которые мы время от времени описывали в книге. Чтобы скомпилировать примеры для какой-либо главы, просто зайдите в директорию с ее номером и наберите простое как мир:
+`javac *.java`
+
+В директории будут присутствовать все файлы, инструменты, значки и ресурсы, необходимые для запуска примеров. Далее вам остается лишь запускать нужные из них. Если вы хотите использовать что-то выглядящее более прилично чем внешний вид Swing по умолчанию, добавьте желаемый внешний вид в список доступных библиотек `CLASSPATH`, и запускайте примеры с ключом:
+`-Dswing.defaultlaf='имя класса внешнего вида'`