# Руководство по обновлению TARS

Как уже упоминалось в [readme](../README_RU.md), TARS — не npm-модуль, поэтому его обновление не происходит одной командой в консоли.

Есть несколько типов обновлений TARS:

* Обновление зависимостей до последних стабильных.
* Обновление TARS целиком.

Первый тип обновления можно выполнить командой `gulp update-deps` (подробнее в основном [readme](../README_RU.md#basic-commands)), а для второго требуется выполнить несколько действий.

Вообще, в рамках мажорной версии (1.\*.\*, например) можно переносить папку markup (папка, в которой должны находиться исходники вашего проекта), в любую версию. В любой версии в рамках одной мажорной сборка пройдет успешно. Данное утверждение справедливо для TARS выше (и включая) версии 1.2.0. До 1.2.0 были небольшие изменения в файловой структуре и способе подключения модулей в handlebars. Все изменения доступны в [changelog](changelog.md).

Таким образом, чтобы получить новую функциональность, которая вышла в новой минорной версии (\*.4.\*, например) достаточно:

* [Скачать новый TARS](https://github.com/2gis/tars/archive/master.zip).
* Проинициализировать его с теми настройками, которые есть в вашем текущем проекте.
* Перенести папку markup из текущего проекта в новый TARS.

После этого вы можете спокойно использовать новый функционал.
Подробнее о системе версионирования можно прочитать [здесь](http://semver.org/lang/ru).

Есть исключение из этого правила. Например, была добавлена работа с coffee-файлами в одной из минорных версий. Если ваш проект использует только js, то вы также можете использовать любую минорную версию в рамках мажорной. Если вы хотите использовать coffee-файлы, то необходимо выбирать только ту версию, в которой были добавлены таски для работы с ними или версию выше.

В основном [readme](../README_RU.md) обязательно будет указано с какой версии есть доступ к той или иной функциоанльности.

Также, если вы вносили изменения в файлы сборщика (что угодно еще, кроме папки markup), то необходимо эти изменения перенести вручную. Все последние изменения в файлах сборщика будут доступны по ссылке: [История изменений](changelog.md).

Для перехода от одной мажорной версии к другой будет написано соответсвующее руководство.