Что это такое
Git Flight Rules — справочник по восстановлению и исправлению типовых проблем в Git. Название отсылает к авиационным flight rules: заранее описанным действиям на случай, когда в полете возникает проблема.
Git мощный, но тревожный инструмент: одна неверная команда может испугать даже опытного разработчика, если непонятно, что именно произошло. Поэтому страница в каталоге рассматривает проект не как строку в рейтинге, а как конкретный инструмент со своим контекстом, типичными сценариями и ограничениями.
Что внутри репозитория
В репозитории находится Markdown-руководство с разделами по коммитам, веткам, rebase, merge, stash, удаленным репозиториям и восстановлению.
Материал построен как набор ситуаций и решений, поэтому его удобно открыть прямо в момент проблемы, а не читать только как учебник. Это важно для оценки проекта: по составу репозитория видно, является ли он библиотекой, приложением, учебным курсом или справочником.
Как это используют
Разработчики используют справочник, когда нужно восстановить потерянную работу, исправить историю, отменить действие или понять безопасную команду.
Лучший способ использовать проект — сначала прочитать сценарий целиком, затем выполнить команды на копии ветки или после проверки `git status` и `git log`. Хороший первый шаг — повторить маленький сценарий из примера ниже, а затем проверить, как проект ведет себя на данных, коде или задачах вашей команды.
Сильные стороны и ограничения
Сильная сторона Git Flight Rules — спокойная практичность: он переводит панику в набор проверяемых шагов.
Ограничение в том, что Git-состояние всегда конкретно; рецепт нужно сопоставлять с текущим графом коммитов, а не запускать команды вслепую.
Практический смысл Git Flight Rules лучше всего виден на маленьком проверяемом сценарии: взять задачу, для которой проект создан, и пройти ее до результата. Git Flight Rules собирает практические рецепты для неприятных Git-ситуаций: ошибочный коммит, потерянная ветка, конфликт, неправильный rebase или случайно измененная история. Так проще понять, какую работу проект действительно снимает с команды.
Если Git Flight Rules остается в работе дольше первого эксперимента, важны сопровождение, обновления, права доступа, лицензия и понятная зона ответственности. Именно здесь обычно проявляется разница между интересным репозиторием и устойчивой частью продукта.
Для каталога важно и то, что Git Flight Rules можно объяснить через практику, а не через сухую карточку метаданных. У проекта есть конкретная аудитория, типичный путь внедрения и набор условий, при которых он становится полезным или, наоборот, лишним.
Пример
Проверка перед исправлением Git-истории
Пример показывает безопасную привычку: сначала посмотреть состояние и граф, а уже потом выбирать рецепт.
git status
git log --oneline --decorate --graph -12