Git Flight Rules is a reference guide that documents solutions to common Git problems and mistakes.
The guide addresses the practical challenge developers face when Git operations go wrong: knowing the correct sequence of steps to recover or fix the situation. It applies the concept of "flight rules" from aerospace—detailed, scenario-specific procedures for handling problems—to Git workflows. Rather than explaining Git theory, the guide collects step-by-step solutions for specific problematic situations, from undoing commits to recovering lost work to fixing branch issues.
Developers should use this guide when they encounter a Git problem and need immediate, actionable steps rather than conceptual explanations. It suits anyone working with Git who wants a quick reference for common mistakes and their remedies. The guide is language-agnostic in its approach, focusing on command sequences that work across different environments, and requires only a reasonably recent Git version to follow the examples.
The project maintains a straightforward reference structure with solutions organized by problem type. The repository accepts contributions that expand the collection of documented scenarios and their solutions, indicating ongoing community involvement in capturing additional edge cases and recovery procedures.
