История версий

Каждый проект хранит собственную историю — так же, как документ в Google Docs: он автоматически сохраняется по ходу работы, и любую точку в этой истории можно назвать, сравнить с другой или к ней вернуться. Нажмите History на панели инструментов, чтобы открыть историю.

Автоматические и именованные версии

• Ваши изменения всегда сохраняются по ходу работы, но автоматическая версия создаётся только тогда, когда вы возвращаетесь к проекту после перерыва (по умолчанию — больше трёх часов): она фиксирует проект ровно таким, каким вы оставили его в конце предыдущей сессии, до того как вступит в силу новое изменение. Непрерывное редактирование не создаёт поток автоматических версий — во время работы никакой таймер не тикает. Их не задумано читать по одной — панель истории скрывает их за переключателем Show auto-saved versions, всегда оставляя видимой самую последнюю.

• Введите сообщение и нажмите Commit, чтобы создать именованную версию — осознанную контрольную точку, например «перед изменением логики цен». Если с последней версии на самом деле ничего не изменилось, это просто назовёт ту версию, а не создаст пустую новую.

• Версию можно переименовать позже прямо из списка истории — независимо от того, была она изначально автоматической или именованной.

• Публикация проекта (кнопка Publish на панели инструментов) всегда создаёт собственную именованную версию, так что точный исходный код опубликованной версии всегда можно найти и сравнить позже.

Сравнение двух версий

Открыв панель истории, вы сразу видите, отличается ли ваша текущая несохранённая работа от последней версии — та же идея «изменений с последнего коммита», что и в системах контроля версий. Нажмите Compare, чтобы увидеть, что именно изменилось, либо воспользуйтесь Compare with working copy / Compare with previousу любой версии в списке.

• Сравнение открывается side-by-side: более ранняя версия слева, более поздняя справа, обе — только для чтения. Добавленные, удалённые, перемещённые и изменённые иконки обведены зелёным, красным, синим и жёлтым.

• Кнопки previous change / next change позволяют пройти по всем отличиям подряд, не разыскивая их самостоятельно на холсте.

• Клик по любой подсвеченной иконке показывает, какие именно поля изменились — старое значение рядом с новым.

• Переименованные, добавленные и удалённые документы и папки тоже показываются в списке, а не только изменения внутри одного документа.

Восстановление более ранней версии

Нажмите Restore у любой версии в списке истории. Проект заменяется содержимым этой версии: документы, которых на тот момент ещё не существовало, удаляются, а удалённые с тех пор — возвращаются. Сразу после этого автоматически создаётся новая версия, фиксирующая само восстановление, так что восстановление никогда не является разрушительным, нигде не зафиксированным действием: версия, из которой вы восстановились, остаётся в истории на своём месте.

Что версионируется не как обычно

Документ Integrations проекта (подключённые аккаунты и учётные данные) версионируется вместе со всем остальным, чтобы можно было увидеть, какие интеграции были настроены в тот или иной момент — но секретная часть каждой учётной записи (API-ключи, токены, пароли) никогда не попадает в содержимое версии, точно так же, как она никогда не попадает в экспорт проекта. Восстановление старой версии никогда не трогает уже сохранённые у вас учётные данные: запись, которая всё ещё существует, сохраняет своё текущее секретное значение, а запись, которой больше нет, возвращается требующей повторного подключения.