mirror/Advanced-Git
1
0
Fork 0
mirror of https://github.com/mike-rambil/Advanced-Git.git synced 2025-12-30 05:59:31 -06:00
Code Issues Packages Projects Releases Wiki Activity

feat: update toc-source.json with new Git command categories and improved descriptions

Browse Source
This commit is contained in:
mikerambil
2025-07-10 21:13:18 -05:00
parent f475fb695c
commit 3891c5562d
2 changed files with 64 additions and 4 deletions
Download Patch File Download Diff File Expand all files Collapse all files

2
dev-docs/FORMAT.md
View File

@@ -19,7 +19,7 @@
# Format for Documenting Git Commands (JSON-Compatible)
This project uses a structured format for documenting Git commands, matching the fields in `toc-source.json`. Use the following template for each command:
This project uses a structured format for documenting Git commands, which is stored in [`../toc-source.json`](../toc-source.json). Use the following template for each command:
---

66
toc-source.json
View File

@@ -1,9 +1,9 @@
[
{
"Name": "Miscellaneous & Orphaned Git Commands",
"Name": "Git Essentials & Hidden Gems",
"category": "Miscellaneous",
"short_description": "Useful Git commands and scripts not referenced elsewhere.",
"long_description": "This file collects useful Git commands and scripts that were previously only in the README and not referenced elsewhere in this repository.",
"short_description": "Start here to discover commands that can improve your workflow and understanding of Git.",
"long_description": "A collection of practical, lesser-known, and foundational Git commands that are useful for all users. Start here to discover commands that can improve your workflow and understanding of Git.",
"tags": ["misc", "cleanup", "advanced"],
"author": "mike-rambil",
"last_updated": "2024-06-10",
@@ -53,6 +53,66 @@
"tags": ["collaboration", "pull-request"],
"author": "mike-rambil",
"last_updated": "2024-06-10"
}
]
},
{
"Name": "Cleanup Branches Fast ⚡",
"category": "Branch Management",
"short_description": "Quickly view and clean up local branches using Bash or PowerShell, including removing branches whose remote is gone.",
"tags": ["branches", "cleanup", "fast", "bash", "powershell"],
"author": "mike-rambil",
"last_updated": "2024-06-10",
"subtoc": [
{
"Name": "Delete Local Branches Whose Remote is Gone (Bash)",
"category": "Branch Management",
"short_description": "Delete all local branches whose remote counterpart has been deleted, using Bash.",
"long_description": "This command fetches the latest remote info and deletes all local branches whose remote tracking branch no longer exists (marked as 'gone'). Useful for cleaning up after remote branch deletions.",
"command": "git fetch -p && git branch -vv | grep '\\[origin/.*: gone\\]' | awk '{print $1}' | xargs -r git branch -d",
"examples": [
{
"code": "git fetch -p && git branch -vv | grep '\\[origin/.*: gone\\]' | awk '{print $1}' | xargs -r git branch -d",
"description": "Delete all local branches whose remote is gone."
}
],
"steps": [
"Fetch latest remote info: git fetch -p",
"List local branches whose remote is gone: git branch -vv | grep '[origin/.*: gone]'",
"Delete those branches: ... | awk '{print $1}' | xargs -r git branch -d"
],
"warnings": [
"This will permanently delete local branches. Double-check before running.",
"Make sure you have no unmerged work on these branches."
],
"tags": ["branches", "cleanup", "gone", "bash"],
"author": "mike-rambil",
"last_updated": "2024-06-10"
},
{
"Name": "Delete Local Branches Whose Remote is Gone (PowerShell)",
"category": "Branch Management",
"short_description": "Delete all local branches whose remote counterpart has been deleted, using PowerShell.",
"long_description": "This script fetches the latest remote info and deletes all local branches whose remote tracking branch no longer exists (marked as 'gone'). Useful for cleaning up after remote branch deletions.",
"command": "git fetch -p\ngit branch -vv | ForEach-Object { if ($_ -match '\\[.*: gone\\]') { $parts = $_.Trim() -split '\\s+'; $branch = $parts[0]; if ($branch -ne '') { git branch -d $branch } } }",
"examples": [
{
"code": "git fetch -p\ngit branch -vv | ForEach-Object { if ($_ -match '[.*: gone]') { $parts = $_.Trim() -split '\\s+'; $branch = $parts[0]; if ($branch -ne '') { git branch -d $branch } } }",
"description": "Delete all local branches whose remote is gone."
}
],
"steps": [
"Fetch latest remote info: git fetch -p",
"List local branches whose remote is gone: git branch -vv | ForEach-Object { if ($_ -match '[.*: gone]') ... }",
"Delete those branches inside the loop."
],
"warnings": [
"This will permanently delete local branches. Double-check before running.",
"Make sure you have no unmerged work on these branches."
],
"tags": ["branches", "cleanup", "gone", "powershell"],
"author": "mike-rambil",
"last_updated": "2024-06-10"
},
{
"Name": "View and Clean Up Local Git Branches (Bash)",