# Nushell Plugins - Guides Directory\n\n**Comprehensive guides for nushell plugin development and version management**\n\n---\n\n## 📚 Available Guides\n\n### 🚀 Quick Start\n\n**[QUICK_START.md](QUICK_START.md)** - Fast track to updating Nushell and creating distributions\n\n**Perfect for**: Getting started immediately, common workflows, quick reference\n\n**Key topics**:\n\n- One-liner updates\n- Creating distributions and bin archives\n- Common workflows\n- Status commands\n- Troubleshooting\n\n---\n\n### 📖 Complete Version Update Guide\n\n**[COMPLETE_VERSION_UPDATE_GUIDE.md](COMPLETE_VERSION_UPDATE_GUIDE.md)** - Comprehensive guide for updating Nushell versions\n\n**Perfect for**: Understanding the complete update process, step-by-step instructions\n\n**Key topics**:\n\n- Complete update workflow (all phases)\n- Plugin updates\n- Distribution creation\n- Validation and testing\n- Troubleshooting\n- Reference commands\n\n---\n\n## 🗂️ Version-Specific Documentation\n\nVersion-specific documentation is located in the `updates/` directory:\n\n```plaintext\nupdates/\n├── 107/              # Nushell 0.107.x documentation\n├── 108/              # Nushell 0.108.x documentation\n│   ├── NUSHELL_0.108_UPDATE_SUMMARY.md       # Complete update summary\n│   ├── MIGRATION_0.108.0.md                  # Migration guide\n│   ├── NUSHELL_UPDATE_AUTOMATION.md          # Automation documentation\n│   └── ... (validation reports, change logs)\n└── 109/              # Future versions...\n```\n\n---\n\n## 🎯 Quick Navigation\n\n### I want to\n\n**...update to a new Nushell version**\n→ Read: [QUICK_START.md](QUICK_START.md#one-liner-update)\n→ Run: `just complete-update 0.108.0`\n\n**...create distribution packages**\n→ Read: [QUICK_START.md](QUICK_START.md#how-do-i-create-distributions-and-bin_archives)\n→ Run: `just create-distribution`\n\n**...update only plugins**\n→ Read: [QUICK_START.md](QUICK_START.md#workflow-2-update-only-plugins)\n→ Run: `just update-plugins 0.108.0`\n\n**...understand the complete process**\n→ Read: [COMPLETE_VERSION_UPDATE_GUIDE.md](COMPLETE_VERSION_UPDATE_GUIDE.md)\n\n**...check migration requirements**\n→ Read: `updates/108/MIGRATION_0.108.0.md`\n\n**...understand the automation**\n→ Read: `updates/108/NUSHELL_UPDATE_AUTOMATION.md`\n\n---\n\n## 🔧 Command Quick Reference\n\n### Update Commands\n\n```bash\n# Complete update\njust complete-update 0.108.0          # All-in-one\njust update-latest                     # Latest version\n\n# Step-by-step\njust update-nushell 0.108.0           # Nushell core only\njust update-plugins 0.108.0           # Plugins only\njust create-distribution              # Distributions only\n```\n\n### Status Commands\n\n```bash\njust update-status                    # Update system status\njust dist-status                      # Distribution status\njust check-versions                   # Version consistency\njust list-versions                    # List plugin versions\njust audit-deps                       # Dependency audit\n```\n\n### Help Commands\n\n```bash\njust update-help                      # Quick command reference\njust update-docs                      # Documentation paths\njust help                            # All available commands\n```\n\n---\n\n## 📖 Documentation Structure\n\n```plaintext\nRepository Documentation:\n├── guides/                           # This directory\n│   ├── README.md                     # This file\n│   ├── QUICK_START.md                # Fast track guide\n│   └── COMPLETE_VERSION_UPDATE_GUIDE.md  # Complete guide\n│\n├── updates/                          # Version-specific docs\n│   ├── 107/\n│   ├── 108/\n│   │   ├── NUSHELL_0.108_UPDATE_SUMMARY.md\n│   │   ├── MIGRATION_0.108.0.md\n│   │   ├── NUSHELL_UPDATE_AUTOMATION.md\n│   │   └── ... (validation, changes, etc.)\n│   └── 109/\n│\n├── README.md                         # Repository overview\n├── CHANGELOG.md                      # All changes\n├── CLAUDE.md                         # Claude Code guidance\n│\n└── scripts/                          # Automation scripts\n    ├── complete_update.nu            # All-in-one updater\n    ├── update_all_plugins.nu         # Bulk plugin updater\n    ├── create_full_distribution.nu   # Distribution creator\n    └── ... (8 total update scripts)\n```\n\n---\n\n## 🎓 Learning Path\n\n### For First-Time Users\n\n1. **Start here**: [QUICK_START.md](QUICK_START.md)\n   - Learn the one-liner update command\n   - Understand what gets created\n\n2. **Then read**: Repository README.md\n   - Understand repository structure\n   - Learn about plugin types\n\n3. **For deeper knowledge**: [COMPLETE_VERSION_UPDATE_GUIDE.md](COMPLETE_VERSION_UPDATE_GUIDE.md)\n   - Complete workflow understanding\n   - Troubleshooting guide\n\n### For Experienced Users\n\n1. **Quick Reference**: [QUICK_START.md](QUICK_START.md)\n   - Command cheat sheet\n   - Common workflows\n\n2. **Automation Details**: `updates/108/NUSHELL_UPDATE_AUTOMATION.md`\n   - How automation works\n   - Customization options\n\n3. **Version Changes**: `updates/108/MIGRATION_0.108.0.md`\n   - Breaking changes\n   - Migration steps\n\n---\n\n## 💡 Tips & Best Practices\n\n### Before Updating\n\n✅ Always check for breaking changes:\n\n```bash\njust detect-breaking\n```\n\n✅ Create a backup:\n\n```bash\ngit stash save "backup before update"\n```\n\n✅ Check current versions:\n\n```bash\njust check-versions\njust audit-deps\n```\n\n### During Update\n\n✅ Use the all-in-one command for simplicity:\n\n```bash\njust complete-update 0.108.0\n```\n\n✅ Monitor progress:\n\n```bash\njust update-status\n```\n\n### After Update\n\n✅ Validate everything works:\n\n```bash\njust validate-code\njust verify-plugins\n```\n\n✅ Create distributions:\n\n```bash\njust create-distribution-all\n```\n\n✅ Commit changes:\n\n```bash\ngit add -A\ngit commit -m "chore: update to Nushell 0.108.0"\n```\n\n---\n\n## 🆘 Getting Help\n\n### Quick Help\n\n```bash\n# Show all update commands\njust update-help\n\n# Show documentation paths\njust update-docs\n\n# Show all available commands\njust help\n```\n\n### Documentation\n\n- **This file**: Overview and navigation\n- **QUICK_START.md**: Fast track and common workflows\n- **COMPLETE_VERSION_UPDATE_GUIDE.md**: Comprehensive guide\n- **updates/108/**: Version-specific documentation\n\n### Online Resources\n\n- [Nushell Book](https://www.nushell.sh/book/)\n- [Plugin Development](https://www.nushell.sh/book/plugins.html)\n- [GitHub Releases](https://github.com/nushell/nushell/releases)\n\n---\n\n## 🔄 Update Workflow Summary\n\n```mermaid\ngraph TD\n    A[Start: New Nushell Version] --> B{Choose Workflow}\n    B -->|All-in-One| C[just complete-update 0.108.0]\n    B -->|Step-by-Step| D[just update-nushell 0.108.0]\n\n    C --> Z[Done! ✅]\n\n    D --> E[just update-plugins 0.108.0]\n    E --> F[just create-distribution]\n    F --> G[just validate-code]\n    G --> Z\n\n    Z --> H[Commit Changes]\n    H --> I[Push to Repository]\n```\n\n---\n\n**Last Updated**: 2025-10-18\n**Current Nushell Version**: 0.108.0\n**Guides Status**: ✅ Complete and ready to use