Библиотека: добавил описания для блоков

src/blocks/close/close.pug

 //- Все примеси в этом файле должны начинаться c имени блока (close)
-//- Принимает:
-//-   label {string} - описание, значение атрибута aria-label
-//- Вызов:
-//-   +close('Закрыть')
 
 mixin close(label)
+
+  //- Принимает:
+  //-   label {string} - описание, значение атрибута aria-label
+  //- Вызов:
+  //-   +close('Закрыть')
+
   button.close(aria-label=label)&attributes(attributes)
     span

src/blocks/page/readme.md

+Блок страницы `html class="page"`, благодаря которому применяются некоторые глобальные стили:
+
+- Смена боксовой модели на всех узлах: `box-sizing: border-box;` наследуется от `html`
+- Нормализация вьюпорта для windows-телефонов.
+- Сброс отступов для `body`
+- Стилевой обход 300 мс задержки `touch-action: manipulation;`
+- Ограничение размера картинок до 100% ширины родителя.
+
+В стилизацию блока включена стилизация «прибитого подвала».

src/blocks/sprite-svg/readme.md

-# svg-спрайт с использованием символов
+Из файлов папки `sprite-svg/svg/` в папку `sprite-svg/img/` будет сгенерирован файл спрайта `sprite-svg.svg`, который далее будет скопирован в папку сборки. Стилевой файл блока не используется. SVG-файлы будут оптимизированы перед сборкой в спрайт. Сам спрайт имеет вид:
 
-**ВНИМАНИЕ!** Чтобы использовать ссылки на внешние svg-файлы со спрайтами, используйте [svg4everybody](https://www.npmjs.com/package/svg4everybody) (включен в сборку по умолчанию).
+<pre class="code">
+  <code>&lt;svg xmlns="http://www.w3.org/2000/svg" style="display:none"&gt;</code>
+  <code>  &lt;symbol id="icon-boo" viewBox="0 0 30 30"&gt;&lt;path d="..."/&gt;&lt;/symbol&gt;</code>
+  <code>  &lt;symbol id="icon-bs" viewBox="0 0 28 28"&gt;&lt;path d="..."/&gt;&lt;/symbol&gt;</code>
+  <code> ...</code>
+  <code>&lt;/svg&gt;</code>
+</pre>
 
-Из файлов папки `svg/` в папку `img/` будет сгенерирован файл спрайта `sprite-svg.svg`.
+Для вставки на страницу используйте конструкции <code>svg &gt; use</code> со ссылками на <code>id</code> символа:
 
-Сам спрайт имеет вид:
+<pre class="code">
+  <code>svg(width="32", height="32")</code>
+  <code>  use(xlink:href="img/sprite-svg.svg#icon-boo")</code>
+</pre>
 
-```html
-<svg xmlns="http://www.w3.org/2000/svg" style="display:none">
-  <symbol id="icon-1" viewBox="0 0 30 30"><path fill="#444" d="..."/></symbol>
-  <symbol id="icon-2" viewBox="0 0 28 28"><path fill="#444" d="..."/></symbol>
-</svg>
-```
+<p class="alert alert--warning">Чтобы использовать ссылки на внешние svg-файлы со спрайтами, используйте <a href="https://www.npmjs.com/package/svg4everybody">svg4everybody</a> (включен в сборку по умолчанию).</p>
 
-Для вставки на страницу используйте конструкции `svg > use` со ссылками на `id` символа:
+Демонстрационный контент блока (иконки стрелок):
 
-```html
-<svg width="30" height="30"><use xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="img/sprite-svg.svg#temp-icon-right-arrow"></use></svg>
-```
+<svg width="32" height="32">
+  <use xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="img/sprite-svg.svg#temp-icon-right-arrow"></use>
+</svg>
+<svg width="32" height="32">
+  <use xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="img/sprite-svg.svg#temp-icon-left-arrow"></use>
+</svg>

src/blocks/sprite-svg/sprite-svg.html

-<!--DEV
-
-Это пример использования спрайта:
-
-<svg width="30" height="30"><use xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="img/sprite-svg.svg#temp-icon-right-arrow"></use></svg>
-
-Для поддержки IE используе svg4everybody — https://www.npmjs.com/package/svg4everybody (по умолчанию включен в сборку, включается в JS-файле этого блока)
-
--->

src/blocks/typo/readme.md

+
+Реализуется блоком `typo`, все стили которого являются глобальными.
+
+Параграфы, расстояние между ними. [Ссылка](qwert1234). Далеко-далеко за словесными горами в стране, гласных и согласных живут рыбные ссылки. Грустный предупредила, дал приставка составитель решила подпоясал запятых сих ручеек которой власти до, над жизни возвращайся силуэт что не курсивных.
+
+Параграфы, расстояние между ними. [Ссылка](/empty). Далеко-далеко за словесными горами в стране, гласных и согласных живут рыбные ссылки. Грустный предупредила, дал приставка составитель решила подпоясал запятых сих ручеек которой власти до, над жизни возвращайся силуэт что не курсивных.
+
+# Заголовок 1
+
+Параграфы, расстояние между ними. [Ссылка](/empty). Далеко-далеко за словесными горами в стране, гласных и согласных живут рыбные ссылки. Грустный предупредила, дал приставка составитель решила подпоясал запятых сих ручеек которой власти до, над жизни возвращайся силуэт что не курсивных.
+
+## Заголовок 2
+
+Параграфы, расстояние между ними. [Ссылка](/empty). Далеко-далеко за словесными горами в стране, гласных и согласных живут рыбные ссылки. Грустный предупредила, дал приставка составитель решила подпоясал запятых сих ручеек которой власти до, над жизни возвращайся силуэт что не курсивных.
+
+### Заголовок 3
+
+Параграфы, расстояние между ними. [Ссылка](/empty). Далеко-далеко за словесными горами в стране, гласных и согласных живут рыбные ссылки. Грустный предупредила, дал приставка составитель решила подпоясал запятых сих ручеек которой власти до, над жизни возвращайся силуэт что не курсивных.
+
+#### Заголовок 4
+
+Параграфы, расстояние между ними. [Ссылка](/empty). Далеко-далеко за словесными горами в стране, гласных и согласных живут рыбные ссылки. Грустный предупредила, дал приставка составитель решила подпоясал запятых сих ручеек которой власти до, над жизни возвращайся силуэт что не курсивных.
+
+##### Заголовок 5
+
+Параграфы, расстояние между ними. [Ссылка](/empty). Далеко-далеко за словесными горами в стране, гласных и согласных живут рыбные ссылки. Грустный предупредила, дал приставка составитель решила подпоясал запятых сих ручеек которой власти до, над жизни возвращайся силуэт что не курсивных.
+
+###### Заголовок 6
+
+Параграфы, расстояние между ними. [Ссылка](/empty). Далеко-далеко за словесными горами в стране, гласных и согласных живут рыбные ссылки. Грустный предупредила, дал приставка составитель решила подпоясал запятых сих ручеек которой власти до, над жизни возвращайся силуэт что не курсивных.
+
+*   Пункт 1
+    *   Подпункт 1
+    *   Подпункт 2
+*   Пункт 2
+*   Пункт 3
+
+1.  Пункт 1
+    1.  Подпункт 1
+    2.  Подпункт 2
+2.  Пункт 2
+3.  Пункт 3
+
+Параграфы, расстояние между ними. [Ссылка](/empty). Далеко-далеко за словесными горами в стране, гласных и согласных живут рыбные ссылки. Грустный предупредила, дал приставка составитель решила подпоясал запятых сих ручеек которой власти до, над жизни возвращайся силуэт что не курсивных.
+
+<dl>
+<dt>Определяемая сущность 1</dt>
+<dd>Некое, возможно, относительно длинное определение упомянутой сущности. Скорее всего, многострочное.</dd>
+<dt>Определяемая сущность 2</dt>
+<dd>Некое, возможно, относительно длинное определение. Скорее всего, длинное, весьма многострочное и многословное.</dd>
+<dd>Некое, возможно, относительно длинное определение упомянутой сущности.</dd>
+</dl>
+
+Параграфы, расстояние между ними. [Ссылка](/empty). Далеко-далеко за словесными горами в стране, гласных и согласных живут рыбные ссылки. Грустный предупредила, дал приставка составитель решила подпоясал запятых сих ручеек которой власти до, над жизни возвращайся силуэт что не курсивных.
+
+* * *
+
+Параграфы, расстояние между ними. [Ссылка](/empty). Далеко-далеко за словесными горами в стране, гласных и согласных живут рыбные ссылки. Грустный предупредила, дал приставка составитель решила подпоясал запятых сих ручеек которой власти до, над жизни возвращайся силуэт что не курсивных.
+
+<table>
+<tbody>
+<tr>
+<td><code>&lt;a></code></td>
+<td><a href="">ссылка</a></td>
+</tr>
+<tr>
+<td><code>&lt;strong></code></td>
+<td>**действительно значимый текст**</td>
+</tr>
+<tr>
+<td><code>&lt;b></code></td>
+<td>**просто выделенный текст, лид**</td>
+</tr>
+<tr>
+<td><code>&lt;i></code></td>
+<td>_иностранное слово или термин_</td>
+</tr>
+<tr>
+<td><code>&lt;em></code></td>
+<td>_эмфатическое ударение_</td>
+</tr>
+<tr>
+<td><code>&lt;s></code></td>
+<td><s>информация, утратившая актуальность</s></td>
+</tr>
+<tr>
+<td><code>&lt;del></code></td>
+<td><del>изменение, внесённое в документ (удаление)</del></td>
+</tr>
+<tr>
+<td><code>&lt;ins></code></td>
+<td><ins>изменение, внесённое в документ (добавление)</ins></td>
+</tr>
+<tr>
+<td><code>&lt;mark></code></td>
+<td><mark>акцент маркерным выделением</mark></td>
+</tr>
+<tr>
+<td><code>&lt;small></code></td>
+<td><small>малозначимый текст</small></td>
+</tr>
+<tr>
+<td><code>&lt;abbr></code></td>
+<td><abbr title="Аббревиатура">АББРЕВИАТУРА</abbr></td>
+</tr>
+<tr>
+<td><code>&lt;kbd></code></td>
+<td><kbd>Ctrl + C</kbd></td>
+</tr>
+<tr>
+<td><code>&lt;sup></code></td>
+<td>2<sup>3</sup></td>
+</tr>
+<tr>
+<td><code>&lt;sub></code></td>
+<td>H<sub>2</sub>O</td>
+</tr>
+<tr>
+<td><code>&lt;code></code></td>
+<td>`code`</td>
+</tr>
+</tbody>
+</table>
+
+<address><b>Имя Фамилия</b> <br>
+г. Лондон, ул. Виндзорский сад, д. 32 (спросить мистера Имя) <br>
+<a href="mailto:user@mail.com">user@mail.com</a></address>
+
+> Цитата. Далеко-далеко за словесными горами в стране. Далеко-далеко за словесными горами в стране.
+>
+> <footer><cite>Emmet</cite></footer>
+
+<pre>// Форматированный текст с символом переноса строки
+// Вторая строка. Смотри так же [БЭМ-блок для кода](#code).
+</pre>