my-git

Recommended Reading

English 中文

This page collects official documentation, classic articles, and well-known materials referenced during subsequent writing.

Principles:

Git Basics and Mental Model

Material Where it’s suitable to add Description
Pro Git 01-getting-started/, 02-daily-workflow/ System learning material recommended by the official Git site
Git Official Documentation All command-related articles Command behavior is subject to official documentation
Git Cheat Sheet 01-getting-started/git-basic-commands.md Use for quick command reference
Conventional Commits 02-daily-workflow/commit-message.md Common reference for commit message specifications
How to Write a Git Commit Message 02-daily-workflow/commit-message.md Classic commit message writing article

Team Workflow

Material Where it’s suitable to add Description
Atlassian Git tutorials 03-team-collaboration/ Covers Centralized, Feature Branch, Gitflow, Forking, Pull Request, and other workflows
GitHub Flow 03-team-collaboration/github-flow.md GitHub’s official lightweight branch workflow
GitHub Flow Enterprise Practice 03-team-collaboration/github-flow.md, 04-github-engineering/enterprise-github-workflow-stack.md How GitHub Flow coordinates with platform governance capabilities to upgrade to an enterprise collaboration workflow
GitLab Flow 03-team-collaboration/team-git-workflow-guide.md Best for teams that require a production / stable branch
Trunk Based Development 03-team-collaboration/trunk-based-development.md Classic material for trunk-based development, short branches, and feature flags
Feature Flags 03-team-collaboration/trunk-based-development.md Key practice for isolating unfinished features in trunk-based development
A successful Git branching model 03-team-collaboration/gitflow.md The classic original article on Gitflow
Google Engineering Practices: Code Review 03-team-collaboration/code-review-best-practices.md Google’s public code review practices
Google Code Review Practice 03-team-collaboration/code-review-best-practices.md Review standards, long-term code health, and categorizing comments
Alibaba AoneFlow Branch Management Practice 03-team-collaboration/team-git-workflow-guide.md, 03-team-collaboration/gitflow.md Multiple features in parallel, combining release branches according to release scope
Tencent Cloud Community Gitflow Branch Specification Practice 03-team-collaboration/gitflow.md Gitflow-style team specification reference
ByteDance Git Workflow and R&D Infrastructure Practice 03-team-collaboration/team-git-workflow-guide.md, 04-github-engineering/ How large-scale R&D infrastructure supports Git workflows
Google Trunk-Based Development and Version Control Practice 03-team-collaboration/trunk-based-development.md Trunk-based development, large-scale collaboration, small changes, and fast CI
Microsoft Release Flow 03-team-collaboration/team-git-workflow-guide.md, 04-github-engineering/release-management.md Team practice of trunk-based development combined with release branches
Big Tech Engineering Practice Decision Map 10-company-practices/ Linking public cases and theme articles according to team problems

GitHub Engineering Governance

Material Where it’s suitable to add Description
Protected branches 04-github-engineering/branch-protection.md Branch protection, required checks, review, Merge Queue
Rulesets 04-github-engineering/rulesets.md Repository and organization-level rule governance
Issue and pull request templates .github/, 08-templates/ Standardizing community contribution information
Pull request reviews 03-team-collaboration/code-review-best-practices.md PR review, CODEOWNERS automatically requesting review
Secret scanning 04-github-engineering/security-and-secret-scanning.md Credential scanning and leak alerts
Push protection 04-github-engineering/security-and-secret-scanning.md Intercepting secrets during the push phase
GitHub Actions Docs 04-github-engineering/github-actions-ci.md GitHub Actions official documentation
Reusable workflows 04-github-engineering/reusable-workflows.md Reusing CI templates across multiple repositories
Gerrit Access Controls 09-resources/gerrit-code-review-governance.md Gerrit permissions, labels, and Submit model
Managing releases in a repository 04-github-engineering/release-management.md GitHub Release official documentation
Semantic Versioning 04-github-engineering/release-management.md Semantic versioning specification
Merge Queue Practice 04-github-engineering/merge-queue.md How teams with high PR concurrency protect main branch stability
Shopify Merge Queue Practice 04-github-engineering/merge-queue.md Experience of large-scale teams using merge queues to protect the main branch
Enterprise GitHub Collaboration Configuration Stack 04-github-engineering/ Combination plan of GitHub Flow, CODEOWNERS, Rulesets, Actions, security scanning, and Merge Queue
GitOps and Config as Code 04-github-engineering/github-engineering-governance.md How configuration, infrastructure, and release strategies enter the PR, review, and CI pipeline
Slack Deploys Practice 04-github-engineering/release-management.md How high-frequency deployment teams reduce daily release risks

Engineering Empirical Research

Material Where it’s suitable to add Description
Do Small Code Changes Merge Faster? 03-team-collaboration/pull-request-best-practices.md Empirical research on the relationship between small changes and merge time
The Impact of a Continuous Integration Service on the Delivery Time of Merged Pull Requests 04-github-engineering/github-actions-ci.md Research on CI’s impact on merge decisions, delivery times, and developer confidence
Git Workflow Empirical Research Notes 03-team-collaboration/, 04-github-engineering/ Turning research conclusions into writing boundaries

AI Programming and Code Review

Material Where it’s suitable to add Description
Responsible use of GitHub Copilot code review 05-ai-native-development/ai-generated-code-review.md GitHub’s official statement on the boundaries of AI Review capabilities
Review AI-generated code 05-ai-native-development/ai-generated-code-review.md Official tutorial for the review process of AI-generated code
OpenAI Codex 05-ai-native-development/codex-claude-code-git-practices.md Codex official product page, including multi-agent workflows and worktrees instructions
OpenAI Codex Web 05-ai-native-development/ai-coding-tools-git-integration.md Codex Web, GitHub integration, and remote task entries
OpenAI Codex Sandboxing 05-ai-native-development/ai-coding-tools-git-integration.md Codex sandbox and permission model
Claude Code Worktrees 05-ai-native-development/codex-claude-code-git-practices.md Claude Code’s official instructions for parallel worktree sessions
Claude Code Common Workflows 05-ai-native-development/codex-claude-code-git-practices.md Claude Code’s official common workflows
GitHub Copilot Cloud Agent 05-ai-native-development/ai-coding-tools-git-integration.md Asynchronous Agent workflow from Issue to PR
Aider Git Integration 05-ai-native-development/ai-coding-tools-git-integration.md git-first local AI pair programming practice
Cursor 2.0 and Composer 05-ai-native-development/ai-coding-tools-git-integration.md Multi-Agent, Composer, and aggregated diff entry
AI Change Review Action Example 05-ai-native-development/ai-native-git-workflow.md, 05-ai-native-development/ai-generated-code-review.md Complete example of AI diff review, cleaning, splitting commits, and writing PRs
Stacked PR for AI-Generated Changes 05-ai-native-development/ai-native-git-workflow.md, 05-ai-native-development/ai-commit-splitting.md How to split AI’s large diffs into reviewable small PRs

Open Source Project Governance

Material Where it’s suitable to add Description
Kubernetes OWNERS Files 04-github-engineering/codeowners.md, 03-team-collaboration/code-review-best-practices.md OWNERS, reviewer / approver two-stage review
Kubernetes Pull Request Process 03-team-collaboration/pull-request-best-practices.md PR process, automated checks, and maintainer collaboration
Linux Kernel Pull Requests 09-resources/open-source-governance-practices.md Maintainer tree model and pull request specifications
Go Contribution Guide 09-resources/open-source-governance-practices.md Gerrit, Review permissions, and contribution process
Rust RFCs 09-resources/open-source-governance-practices.md Major change RFC model

Troubleshooting and Recovery

Material Where it’s suitable to add Description
Git Flight Rules 06-troubleshooting/ High-frequency Git incident handling checklist
git reflog 06-troubleshooting/recover-lost-commit.md Core command to recover lost commits
git restore 06-troubleshooting/undo-anything.md Undo changes in the working tree and staging area
How to undo almost anything with Git 06-troubleshooting/undo-anything.md GitHub’s classic undo guide
Removing sensitive data from a repository 06-troubleshooting/remove-secret-from-history.md GitHub’s official instructions for clearing sensitive data
git filter-repo 06-troubleshooting/remove-secret-from-history.md Common tool for cleaning Git history

Large Repositories and Monorepos

Material Where it’s suitable to add Description
Partial clone 07-large-repo/partial-clone.md Reduce object downloads
Sparse checkout 07-large-repo/sparse-checkout.md Keep only parts of the worktree paths
git worktree 02-daily-workflow/worktree.md, 05-ai-native-development/worktree-for-ai-agents.md Multi-branch parallel worktrees
Git LFS 07-large-repo/git-lfs.md Git large file management tool
Pro Git: Submodules 07-large-repo/submodule-vs-subtree.md Submodule system explanation
git maintenance 07-large-repo/repo-maintenance.md Repository maintenance commands
Microsoft Scalar and Large Repository Git Practice 07-large-repo/large-repo-git-practices.md Combination practice of partial clone, sparse checkout, and maintenance
Meta Sapling and Stacked Commits Practice 03-team-collaboration/pull-request-best-practices.md, 07-large-repo/ Stacked commits and massive repository development experience
Uber GitFarm and Git as a Service Practice 07-large-repo/large-repo-git-practices.md Git as a large-scale monorepo infrastructure service
Git Version Upgrade Notes 07-large-repo/large-repo-git-practices.md, 09-resources/ Capabilities worth engineering teams’ attention in Git 2.45 to 2.54