From 60b62e370ee566010f88e65df3981125dc17be2d Mon Sep 17 00:00:00 2001 From: Spartan322 Date: Thu, 7 Sep 2023 16:06:30 -0400 Subject: Simplify README.md Add system-requirements.md Add using-git-bisect.md Add run-build-export.md Add cloning.md Add debugging.md Add rebasing.md Includes PR squashing Simplify .vscode/launch.json --- docs/contribution/using-git-bisect.md | 24 ++++++++++++++++++++++++ 1 file changed, 24 insertions(+) create mode 100644 docs/contribution/using-git-bisect.md (limited to 'docs/contribution/using-git-bisect.md') diff --git a/docs/contribution/using-git-bisect.md b/docs/contribution/using-git-bisect.md new file mode 100644 index 0000000..ea6135b --- /dev/null +++ b/docs/contribution/using-git-bisect.md @@ -0,0 +1,24 @@ +# Using Git Bisect + +Git bisect is a very useful tool for debugging issues that you can't find the root of, specifically when you know a period in the commit history where that issue did not exist. + +How git bisect works is by binary searching through the commit history marking commits as good or bad until you reach the history responsible for the issue at hand. + +To start using it you must do: +```sh +git bisect start +git bisect good +git bisect bad +``` + +The bisect will begin, it will perform a binary search and put you at a specific commit, if the commit still has the bug then run: +```sh +git bisect bad +``` +If the commit doesn't have the bug then run: +```sh +git bisect good +``` +When done it will stop at the responsible commit for which you can investigate to see whats causing the issue. + +For more documentation on git bisect see: https://git-scm.com/docs/git-bisect \ No newline at end of file -- cgit v1.2.3-56-ga3b1