Merge pull request #611 from bem/restrry.doc-common

Move docs to common level

blocks-common/b-icon/b-icon.en.md

@@ -0,0 +1,7 @@
+This is an abstract container for an icon.
+
+The block has optional attributes: `alt`, `url`, `width`, `height`.
+
+Set property `url` to make **b-icon** with another image. The same for attributes `alt`, `width` and `height`.
+
+It is possible to use css sprites and single images for the block by using css-property `background: url(...);`

blocks-common/b-icon/b-icon.ru.md

@@ -0,0 +1,10 @@
+##Описание
+Блок `b-icon` создает контейнер для изображения. Предоставляет возможность добавлять и редактировать изображение без необходимости правки родительского блока.
+
+##Атрибуты блока
+Имеет опциональные атрибуты блока:
+
+* `alt` – устанавливает альтернативный текст для изображений. Такой текст позволяет получить текстовую информацию о рисунке при отключенной в браузере загрузке изображений.
+* `url` – задавая url, можно подставлять b-icon новую картинку, со своим alt, шириной и высотой.
+* `width`  устанавливает ширину изображения. Допускается использовать значения в пикселах или процентах. Если установлена процентная запись, то размеры изображения вычисляются относительно родительского элемента — контейнера, где находится тег `<img>`.
+* `height` – устанавливает высоту изображения. Допускается использовать значения в пикселах или процентах. Если установлена процентная запись, то размеры изображения вычисляются относительно родительского элемента — контейнера, где находится тег `<img>`.