content/index.md

@@ -2,14 +2,17 @@
 title: Инструкция по работе над сайтом
 ---
 
-## Запустите скрипт для работы над сайтом
+1. Содержание
+{:toc}
+
+## Запустите скрипт для работы над сайтом {#run}
 
 Если вы читаете эту инструкцию, то скорее всего, уже запустили этот
 скрипт. Он должен быть у вас на рабочем столе.
 
-## Обновите репозиторий
+## Обновите репозиторий {#repo-update}
 
-### Скачайте изменения
+### Скачайте изменения {#fetch}
 
 На этом этапе git скачает изменения, сделанные другими разработчиками, но не
 объединит их с вашими.
@@ -20,8 +23,9 @@ title: Инструкция по работе над сайтом
 
 ### Слейте изменения {#merge}
 
-Чтобы получить изменения, опубликованные на сайте, слейте в master ветку
-origin/master.
+Чтобы получить изменения, опубликованные на сайте, слейте ветку origin/master в
+ту ветку, где вы работаете. Если вы еще не сделали ветку себе для работы или
+собираетесь публиковать изменения, слейте origin/master в master.
 
 При слиянии вы должны находиться на той ветке, куда сливаете другую
 (если вы находитесь на другой ветке, [переключитесь](#checkout) на
@@ -33,10 +37,18 @@ origin/master.
 
 ![Merge tracking branch origin/master](img/merge-origin-master.png)
 
-## Переключитесь на нужную ветку
+Если все хорошо, работайте дальше. В некоторых случаях на этом этапе может
+возникнуть конфликт слияния. Он происходит, когда в разных ветках изменена одна
+и та же часть какого-то файла. В этом случае необходимо выбрать, какой вариант
+использовать, отредактировать файлы соответствующим образом и [создать
+коммит](#commit), когда файлы будут выглядеть так, как вы хотите, чтобы они были
+объединены. При необходимости, обратитесь за помощью.
+
+## Работайте в правильной ветке {#branches}
 
-Если у вас нет ветки, в которой вы собираетесь работать, создайте ее,
-если есть --- переключитесь на нее.
+Если у вас нет ветки, в которой вы собираетесь работать, создайте ее; если есть
+--- переключитесь на нее. Если вы уже на ней, [переходите к
+редактированию](#edit).
 
 Если изменения не очень существенные или не относятся к одному
 направлению, вы можете использовать персональную ветку.
@@ -44,7 +56,7 @@ origin/master.
 Не работайте в master. Пусть master будет содержать только то, что
 либо уже находится на сайте, либо прямо сейчас будет туда загружено.
 
-### Создание ветки
+### Создание ветки {#create-branch}
 
 ![Branch - Create](img/create-branch.png)
 
@@ -70,7 +82,7 @@ origin/master.
 аналогично тому, [что вы уже делали](#merge), только сливайте не в master, а в
 ту ветку, которую вы хотите обновить.
 
-## Редактируйте файлы
+## Редактируйте файлы {#edit}
 
 Все тексты хранятся в папке content. Для добавлении новой новости
 создайте файл в папке content/news. Называйте файлы по шаблону
@@ -109,7 +121,7 @@ origin/master.
 Когда сайт скомпилируется, закройте возникшее окно. Посмотреть
 изменения можно по адресу <http://localhost:3000>
 
-### Разметка
+### Разметка {#markup}
 
 В качестве разметки используется Markdown (если точнее, то kramdown).
 
@@ -204,7 +216,7 @@ Git позволяет разделять изменения на несколь
 
 При отсылке изменений у вас могут потребовать пароль.
 
-## Публикация изменений
+## Публикация изменений {#publish}
 
 **Внимание!** На момент написания этой части инструкции, у вас нет
 возможности самостоятельно публиковать изменения: у вас просто нет в
@@ -217,8 +229,8 @@ Git позволяет разделять изменения на несколь
 
 ![status](img/rescan-no-changes.png)
 
-[Переключитесь](#checkout) на master и [слейте](#merge) туда ту ветку,
-в которой вы работали.
+[Переключитесь](#checkout) на master и [слейте](#merge) туда сначала
+origin/master, а потом ту ветку, в которой вы работали.
 
 [Скомпилируйте сайт](#compile) и убедитесь, что все правильно.
 
@@ -232,12 +244,12 @@ master.
 При публикации может быть запрошен пароль от ключа либо от аккаунта на
 хостинге.
 
-## Дополнительно
+## Дополнительно {#additional}
 
 То, что описано в этом разделе не обязательно вам потребуется, но
 лучше, чтобы вы знали, как это делается.
 
-### Просмотр истории
+### Просмотр истории {#history}
 
 ![Repository - Visualize All Branch History](img/visualize-hist.png)
 
@@ -252,7 +264,7 @@ master.
 В нижней части можно посмотреть полное сообщение к коммиту и
 изменения, вошедшие в него либо весь репозиторий в тот момент.
 
-### Обновление этой инструкции
+### Обновление этой инструкции {#instruction-update}
 
 Эту инструкцию проще всего обновлять через терминал. Откройте его из
 системного меню и введите туда команды: