@jmruthers/pace-core 0.6.1 → 0.6.2

package/docs/migration/README.md

@@ -6,12 +6,25 @@ reviewedBy: documentation-standards-audit
 
 # Migration Guide
 
-> **🔄 Upgrade and Migration** | [Unified Migration Guide](./MIGRATION_GUIDE.md) | [RBAC Migration](./rbac-migration.md)
+> **🔄 Upgrade and Migration** | [Unified Migration Guide](./MIGRATION_GUIDE.md) | [RBAC Migration](./V0.4.0_rbac-migration.md)
 
 [← Back to Documentation](../README.md) | [↑ Table of Contents](#table-of-contents) | [Next: Unified Migration Guide →](./MIGRATION_GUIDE.md)
 
 Complete migration guides for upgrading to and between versions of `@jmruthers/pace-core`.
 
+## 📖 Documentation Structure
+
+This migration documentation follows a clear structure to help you find the information you need:
+
+- **CHANGELOG.md**: High-level announcements and summaries with links to detailed guides
+- **Migration Guides**: Step-by-step instructions, code examples, and troubleshooting
+  - **Version-Specific**: `V0.5.190_TO_V0.6.1_MIGRATION.md` - Complete migration for specific versions
+  - **Feature-Specific**: `V0.6.0_REACT_19_MIGRATION.md`, `V0.4.0_rbac-migration.md` - Focused guides for specific features (with version stamps at start)
+  - **Database-Specific**: `database-changes-december-2025.md` - Database schema changes
+  - **General**: `MIGRATION_GUIDE.md` - General migration patterns and best practices
+
+**For documentation structure guidelines, see:** [Documentation Structure](./DOCUMENTATION_STRUCTURE.md)
+
 ## 📚 Start Here: Unified Migration Guide
 
 **For all migrations, start with:** [Complete Migration Guide](./MIGRATION_GUIDE.md)
@@ -29,6 +42,8 @@ The unified guide provides:
 - [Quick Migration Checklist](#-quick-migration-checklist)
 - [Version Migrations](#-version-migrations)
 - [Critical Fixes](#-critical-fixes)
+  - [v0.5.190 → v0.6.1 Comprehensive Migration Guide](#v05190--v061-comprehensive-migration-guide)
+  - [Person-Scoped Profiles Migration](#person-scoped-profiles-migration-v05190)
 - [From Other Libraries](#-from-other-libraries)
 - [RBAC Migration](#-rbac-migration)
 - [Migration Tools](#-migration-tools)
@@ -64,6 +79,25 @@ This guide covers:
 
 ## 🚨 Critical Fixes
 
+### v0.5.190 → v0.6.1 Comprehensive Migration Guide
+
+**NEW**: Complete migration guide for upgrading from v0.5.190 to v0.6.1.
+
+**Breaking Changes:**
+- React 19 upgrade (all apps must upgrade)
+- Database schema changes (table naming standardization)
+- Person-scoped profiles migration
+
+**Migration Guide**: [v0.5.190 → v0.6.1 Migration Guide](./V0.5.190_TO_V0.6.1_MIGRATION.md)
+
+**Quick Summary**:
+- Upgrade React to 19.2.3+
+- Apply database migrations
+- Update all table name references
+- Remove `organisation_id` filters from profile queries
+- Configure React Compiler
+- See full guide for detailed instructions
+
 ### Person-Scoped Profiles Migration (v0.5.190+)
 
 **BREAKING CHANGE**: Profiles (membership, medical, and contact) have been migrated from organisation-scoped to person-scoped.
@@ -74,7 +108,7 @@ This guide covers:
 - One membership per person (enforced by unique constraint)
 - Related tables (`pace_consent`, `pace_identification`, `pace_qualification`, etc.) also no longer have `organisation_id`
 
-**Migration Guide**: [Person-Scoped Profiles Migration Guide](./person-scoped-profiles-migration-guide.md)
+**Migration Guide**: [Person-Scoped Profiles Migration Guide](./V0.5.190_person-scoped-profiles-migration-guide.md)
 
 **Quick Summary**:
 - Remove all `organisation_id` filters/queries for profile tables
@@ -91,7 +125,7 @@ This guide covers:
 - Super admin permissions returning false
 - Potential data leakage between organisations
 
-**Migration**: [Organisation Context Timing Fix](./organisation-context-timing-fix.md)
+**Migration**: [Organisation Context Timing Fix](./V0.3.44_organisation-context-timing-fix.md)
 
 **Quick Fix**:
 ```bash
@@ -393,7 +427,7 @@ function MyComponent() {
 
 ## 🔐 RBAC Migration
 
-For detailed RBAC migration, see the [RBAC Migration Guide](./rbac-migration.md).
+For detailed RBAC migration, see the [RBAC Migration Guide](./V0.4.0_rbac-migration.md).
 
 ### Quick RBAC Migration
 
@@ -487,8 +521,20 @@ import '@jmruthers/pace-core/src/styles/core.css';
 
 ## 📚 Additional Resources
 
-- **[RBAC Migration Guide](./rbac-migration.md)** - Detailed RBAC migration
-- **[Migration Guide](./MIGRATION_GUIDE.md)** - Complete migration reference
+### Migration Guides
+
+- **[Complete Migration Guide](./MIGRATION_GUIDE.md)** - General migration patterns and best practices
+- **[v0.5.190 → v0.6.1 Migration Guide](./V0.5.190_TO_V0.6.1_MIGRATION.md)** - Comprehensive migration for v0.6.1
+- **[React 19 Migration Guide](./V0.6.0_REACT_19_MIGRATION.md)** - React 19 upgrade instructions (v0.6.0)
+- **[RBAC Migration Guide](./V0.4.0_rbac-migration.md)** - RBAC system migration (v0.4.0+)
+- **[Person-Scoped Profiles Migration](./V0.5.190_person-scoped-profiles-migration-guide.md)** - Profile migration guide (v0.5.190+)
+- **[Database Changes December 2025](./database-changes-december-2025.md)** - Database schema changes
+- **[Migration Guide](./MIGRATION_GUIDE.md)** - Comprehensive migration guide with quick reference table
+
+### Documentation
+
+- **[Documentation Structure](./DOCUMENTATION_STRUCTURE.md)** - Guidelines for CHANGELOG and migration docs
+- **[CHANGELOG.md](../../CHANGELOG.md)** - Version history and change announcements
 - **[Common Issues](../troubleshooting/common-issues.md)** - Troubleshooting migration issues
 - **[API Reference](../api-reference/)** - Complete API documentation