74
docs/VERSION_UPDATE.md
Normal file
74
docs/VERSION_UPDATE.md
Normal file
@@ -0,0 +1,74 @@
|
||||
# 🚀 Quick Version Update Guide
|
||||
|
||||
**Current Version**: `6.10.0`
|
||||
|
||||
---
|
||||
|
||||
## Fast Track (5 minutes)
|
||||
|
||||
### 1. Run the COMPREHENSIVE automated script
|
||||
```bash
|
||||
cd /opt/media-downloader
|
||||
bash scripts/update-all-versions.sh 6.11.0 # Replace with your new version
|
||||
```
|
||||
|
||||
This script updates **ALL** version references across the entire codebase automatically!
|
||||
|
||||
### 2. Update changelogs (manual)
|
||||
- Edit `data/changelog.json` - add entry at TOP
|
||||
- Edit `docs/CHANGELOG.md` - add section at TOP
|
||||
|
||||
### 3. Finalize
|
||||
```bash
|
||||
# Services restart automatically (dev server running)
|
||||
# Or manually restart:
|
||||
sudo systemctl restart media-downloader-api media-downloader.service
|
||||
|
||||
# Create version backup
|
||||
bash scripts/create-version-backup.sh
|
||||
```
|
||||
|
||||
### 4. Verify
|
||||
- Open browser: Check login page shows correct version
|
||||
- Check Dashboard loads correctly
|
||||
- Check Configuration page shows correct version
|
||||
- Verify Health page loads
|
||||
|
||||
---
|
||||
|
||||
## Files Updated by Script (Automatic)
|
||||
|
||||
✅ `/opt/media-downloader/VERSION`
|
||||
✅ `/opt/media-downloader/README.md` (header + directory structure comment)
|
||||
✅ `web/frontend/src/pages/Login.tsx`
|
||||
✅ `web/frontend/src/App.tsx` (2 locations)
|
||||
✅ `web/frontend/src/pages/Configuration.tsx` (multiple locations)
|
||||
✅ `web/frontend/package.json`
|
||||
|
||||
---
|
||||
|
||||
## Manual Updates Required
|
||||
|
||||
❌ `data/changelog.json` - Add new version entry
|
||||
❌ `CHANGELOG.md` - Add new version section
|
||||
|
||||
---
|
||||
|
||||
## Full Documentation
|
||||
|
||||
For complete checklist and troubleshooting:
|
||||
📖 **[docs/VERSION_UPDATE_CHECKLIST.md](docs/VERSION_UPDATE_CHECKLIST.md)**
|
||||
|
||||
---
|
||||
|
||||
## Version Number Format
|
||||
|
||||
Follow [Semantic Versioning](https://semver.org/): `MAJOR.MINOR.PATCH`
|
||||
|
||||
- **6.x.0** - Major features, breaking changes
|
||||
- **6.4.x** - New features, backward-compatible
|
||||
- **6.4.2** - Bug fixes, patches
|
||||
|
||||
---
|
||||
|
||||
**Last Updated**: 2025-10-31
|
||||
Reference in New Issue
Block a user