docs: pull changes of specific files

Author: mike-rambil

toc-source.json

@@ -494,7 +494,10 @@
         ],
         "tags": ["patch", "format-patch", "committed"],
         "links": [
-          {"label": "Official Docs", "url": "https://git-scm.com/docs/git-format-patch"}
+          {
+            "label": "Official Docs",
+            "url": "https://git-scm.com/docs/git-format-patch"
+          }
         ],
         "author": "mike-rambil",
         "last_updated": "2024-06-10"
@@ -534,7 +537,10 @@
         ],
         "tags": ["diff", "uncommitted", "snapshot"],
         "links": [
-          {"label": "Official Docs", "url": "https://git-scm.com/docs/git-diff"}
+          {
+            "label": "Official Docs",
+            "url": "https://git-scm.com/docs/git-diff"
+          }
         ],
         "author": "mike-rambil",
         "last_updated": "2024-06-10"
@@ -565,5 +571,41 @@
         "last_updated": "2024-06-10"
       }
     ]
+  },
+  {
+    "Name": "Pull Changes of Specific Files from a Commit",
+    "category": "Selective File Restore",
+    "short_description": "Restore or pull changes for specific files from a past commit without reverting the entire commit.",
+    "long_description": "How to use git to pull or restore changes for only certain files from a specific commit, without affecting the rest of your working directory or reverting the whole commit. Useful for cherry-picking file-level changes.",
+    "command": "git checkout <commit-hash> -- <file1> <file2>",
+    "examples": [
+      {
+        "code": "git checkout e8ab7f64fdfcc7bdaaed8d96c0ac26dce035663f -- path/to/file1.txt path/to/file2.txt",
+        "description": "Restore file1.txt and file2.txt from the specified commit."
+      },
+      {
+        "code": "git add path/to/file1.txt path/to/file2.txt\ngit commit -m \"Pulled changes for file1.txt and file2.txt from commit e8ab7f64\"\ngit push origin revert/productionOrder",
+        "description": "Stage, commit, and push the restored files to a new branch."
+      }
+    ],
+    "steps": [
+      "Checkout the specific files from the desired commit using 'git checkout <commit-hash> -- <file1> <file2>'.",
+      "Stage the changes with 'git add <file1> <file2>'.",
+      "Commit the changes with a descriptive message.",
+      "Push your branch and create a pull request if needed."
+    ],
+    "warnings": [
+      "This will overwrite the current working directory versions of the specified files.",
+      "Make sure to commit or stash any local changes to those files before running the command."
+    ],
+    "tags": ["checkout", "restore", "file", "commit", "cherry-pick"],
+    "author": "mike-rambil",
+    "last_updated": "2024-06-10",
+    "links": [
+      {
+        "label": "Git Docs: git checkout",
+        "url": "https://git-scm.com/docs/git-checkout"
+      }
+    ]
   }
 ]