2026-03-11 03:22:42 +00:00
|
|
|
# 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
|
