2 Commits 01d218e350 ... f6a514e79a

Author SHA1 Message Date
  Anton Tsyganenko f6a514e79a Merge branch 'updates' 5 years ago
  Anton Tsyganenko fc9a031d0e обновил инструкцию 5 years ago
1 changed files with 34 additions and 22 deletions
  1. 34 22
      content/index.md

+ 34 - 22
content/index.md

@@ -11,7 +11,8 @@ title: Инструкция по работе над сайтом
 
 ### Скачайте изменения
 
-На этом этапе git скачает изменения, но не объединит их с вашими
+На этом этапе git скачает изменения, сделанные другими разработчиками, но не
+объединит их с вашими.
 
 ![Remote - Fetch from - origin](img/fetch.png)
 
@@ -19,7 +20,8 @@ title: Инструкция по работе над сайтом
 
 ### Слейте изменения {#merge}
 
-Чтобы обновить ветку master, слейте в нее ветку origin/master.
+Чтобы получить изменения, опубликованные на сайте, слейте в master ветку
+origin/master.
 
 При слиянии вы должны находиться на той ветке, куда сливаете другую
 (если вы находитесь на другой ветке, [переключитесь](#checkout) на
@@ -36,7 +38,7 @@ title: Инструкция по работе над сайтом
 Если у вас нет ветки, в которой вы собираетесь работать, создайте ее,
 если есть --- переключитесь на нее.
 
-Если измениния не очень существенные или не относятся к одному
+Если изменения не очень существенные или не относятся к одному
 направлению, вы можете использовать персональную ветку.
 
 Не работайте в master. Пусть master будет содержать только то, что
@@ -46,25 +48,27 @@ title: Инструкция по работе над сайтом
 
 ![Branch - Create](img/create-branch.png)
 
-В окне введите название ветки. Убедитесь, что все как на скриншоте
-(список веток может быть другой, но должен быть выбран master).
+В окне введите название ветки. Выберите ветку, на которой новая должна
+основываться (если не уверены, выберите master). Проверьте, что стоит флаг
+"Checkout After Creation", чтобы сразу переключиться на новую ветку.
 
 ![](img/create-branch-dialog.png)
 
-Тогда при создании git автоматически переключится на новую ветку.
-
 ### Переключение на ветку {#checkout}
 
+Если ветка уже существует, но вы находитесь не на ней (текущая ветка
+показывается в левом верхнем углу), переключитесь на нужную ветку.
+
 ![Branch - Checkout](img/checkout.png)
 
 Выберите ветку, на которую хотите переключиться:
 
 ![](img/checkout-dialog.png)
 
-Если вы используете персональную ветку, вам может потребоваться
-сливать в нее изменения, сделанные другими. Слияние делается
-аналогично тому, [что вы уже делали](#merge), только сливайте не в
-master, а в ту ветку, которую вы хотите обновить.
+Если вы используете персональную ветку, вам может потребоваться сливать в нее
+изменения, сделанные другими людьми или в других ветках. Слияние делается
+аналогично тому, [что вы уже делали](#merge), только сливайте не в master, а в
+ту ветку, которую вы хотите обновить.
 
 ## Редактируйте файлы
 
@@ -130,20 +134,20 @@ master, а в ту ветку, которую вы хотите обновить
     2. Второй элемент
     9. Третий элемент. Цифра не важна, на сайте будет цифра 3.
 
-Ссылки деляются так: в квадратных скобках пишете текст ссылки, а в
-круглуых (они должны стоять сразу после квадратных) то, куда
-пользователь попадет, кликнув по ней:
+Ссылки делаются так: в квадратных скобках пишете текст ссылки, а в круглых (они
+должны стоять сразу после квадратных) то, куда пользователь попадет, кликнув по
+ней:
 
     [Текст ссылки](http://example.com/)
 
 Отображаться будет так: [Текст ссылки](http://example.com/).
 
-Заголоки делаются так:
+Заголовки делаются так:
 
     ## Раздел Первый
-    
+
     ### Статья 1
-    
+
     #### Пункт 1.1.1
 
 Количество решеток соответствует уровню заголовка. Чем меньше уровень
@@ -151,7 +155,11 @@ master, а в ту ветку, которую вы хотите обновить
 используйте их в тексте. Заголовки 2 уровня --- названия разделов
 страницы, 3 уровня --- подразделов и т. д. Всего 6 уровней.
 
-## Закоммитьте изменения
+## Закоммитьте изменения {#commit}
+
+Коммит (снимок) --- это сохраненное состояние репозитория со вспомогательной
+информацией, помогающей отличить данное состояние от других (время фиксации,
+автор, родительский коммит (тот, на котором основывается данный) и т.д.).
 
 Пересканируйте изменения:
 
@@ -163,20 +171,20 @@ Git позволяет разделять изменения на несколь
 войти в коммит. Если вы хотите зафиксировать все изменения, нажмите
 кнопку "Stage Changed", для добавления отдельных файлов нажмите на их
 иконку, для кусков файлов или строк используйте контекстное меню
-(вызывается правой кнопкой мыши)
+(вызывается правой кнопкой мыши).
 
 ![](img/stage.png)
 
 Если вы передумали добавлять что-то, изменения удаляются из области
 подготовленных файлов почти так-же: кликните на иконку добавленного
 файла, чтобы отменить его изменение или в контекстном меню выберите
-"Unstage Hunk/Line From Commit"
+"Unstage Hunk/Line From Commit".
 
 Проверьте, что в коммит войдут все нужные изменения и только они
 (иногда могут случайно появляться ненужные файлы или изменения). Чтобы
 посмотреть различие, кликайте по имени файла.
 
-В поле ввода сообщения кратко опишите измения. Если хотите описать
+В поле ввода сообщения кратко опишите изменения. Если хотите описать
 подробно, в первой строчке опишите кратко, вторую оставьте пустой, а
 дальше пишите подробно.
 
@@ -184,6 +192,10 @@ Git позволяет разделять изменения на несколь
 
 ## Отошлите изменения {#push}
 
+На этом этапе вы отправите свои [закоммиченные](#commit) наработки в удаленный
+репозиторий, чтобы сделать их доступными другим разработчикам. Это не изменит
+сайт для посетителей.
+
 ![Push](img/push.png)
 
 В диалоговом окне выберите ветку, в которой вы работали:
@@ -210,7 +222,7 @@ Git позволяет разделять изменения на несколь
 
 [Скомпилируйте сайт](#compile) и убедитесь, что все правильно.
 
-[Отправьте](#push) изменения в репозиторий, на этот раз выбрав ветку
+[Отправьте](#push) изменения в удаленный репозиторий, на этот раз выбрав ветку
 master.
 
 Отправьте скомпилированный сайт на хостинг: