Merge revision research into canonical plan - #14
Merged
Conversation
ben
force-pushed
the
merge-revision-research
branch
from
August 2, 2026 14:41
0ac8d9e to
1f100d3
Compare
Integrates two supplementary research documents into REVISION_PLAN.md: - 3rd-edition-audit.md: chapter-by-chapter ecosystem/tooling audit - git_features_2014_2024.md: Git 2.0–2.47 feature chronology Key additions per-chapter: - Ch 1: platform version cleanup, id_dsa removal, modern help resources - Ch 2: git:// legacy, stash push, .mailmap default, :(attr:) pathspec - Ch 3: git switch primary, ort strategy, rebase backend, modern workflows, worktree intro - Ch 4: SSH key cleanup, Apache 2.4, LFS section, hosting landscape expansion - Ch 5: gh CLI, CI/CD integration, trunk-based, Gmail security note - Ch 6: 13-bullet expansion (Actions, Apps, gh CLI, passkeys, branch protection, etc.) - Ch 7: GPG key size, bisect run, autosquash non-interactive, stash push, submodule cleanup - Ch 8: includeIf, core.hooksPath, XDG prominence, url.insteadOf, committer overrides - Ch 9: forge migration section, Perforce scope, structural rename decision - Ch 10: dumb protocol shrink, Pack v2, commit-graph, partial clone internals - App A: Fish/Starship, AI tools, GUI survey update - App B: gitoxide, libgit2 bindings expansion Also adds: - git merge-tree to new commands table - Recommended items 8-9 (merge-tree, stacked PRs) - Step 0 in sequencing for open structural decisions (Ch 6 split, Ch 9 rename) - Effort by chapter summary table
ben
force-pushed
the
merge-revision-research
branch
from
August 2, 2026 14:43
1f100d3 to
6058ccb
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
(Ben:) I let an opus run with the full release-notes site and its training data, and it came up with more details about what needs to be updated for 3e.
Source documents
3rd-edition-audit.md— chapter-by-chapter ecosystem/tooling audit covering GitHub UI changes, hosting landscape, IDE tooling, and staleness items not tied to Git 3.0.git_features_2014_2024.md— chronological inventory of Git 2.0–2.47 feature changes used to cross-reference both planning docs.What changed in REVISION_PLAN.md
Per-chapter additions
id_dsa→ Ed25519, Notepad++ removal, modern help resourcesgit://→ legacy,git stash save→push,.mailmapdefault (2.23),:(attr:...)pathspec (2.44)git switch/switch -cas primary, ort merge strategy (2.34), rebase merge-backend note (2.26), modern workflows (GitHub Flow, trunk-based, stacked diffs), briefgit worktreeintroid_dsa,-ocaveat,authorized_keys2),xinetd/sysvinitremoval, Apache 2.4 syntax fix,.htpasswdsecurity note, hosting landscape expansion (Codeberg, Sourcehut, Azure DevOps), Git LFS section, partial clones sectionghCLI, CI/CD integration, trunk-based development,git request-pullniche context, Gmail plaintext password security noteghCLI, branch protection, CODEOWNERS, Dependabot, Discussions, Packages, Copilot/AI, Octokit expansion. Flags the structural decision: split into two chapters or expand as one.git bisect run, rebase--autosquashnon-interactive (2.44), rebase auto-skip baseline (2.34),git stash save→push, submodule version-gate cleanupincludeIf,core.hooksPath, modern hooks survey, XDG config prominence,url.insteadOf, committer config overrides (2.22)commit-graphcoverage, partial clone internalsgitoxide(Rust) section, libgit2 bindings expansion (Rust/Go/Python/Node)Structural additions
git merge-tree(2.38) added to new commands tablegit merge-tree, stacked diffs/PRs