= Godot 4 Migration Plan

== Pre-Planning
1. Research GDExtension replacing GDNative
1. Research any breaking changes introduced in GDScript

== Deployment
1. Move [source:Revenant Revenant code] onto a 3.x branch
1. Move [source:Studio Godot Studio] files onto a 3.x branch
1. Fork Godot core, move existing into a 3.x folder
1. Install Godot 4
1. Install Zylann for GD4
1. Rebuild everything
1. Profit

= Migration Rollout
How to upgrade to Godot 4? all at once or partial upgrade in phases?

Dev snapshot is [https://godotengine.org/article/dev-snapshot-godot-4-0-alpha-4 presently in Alpha 4 release], they state there will be breaking changes between alpha releases due to the fact it is not feature-complete yet.

== Partial Migration
Kevin works on v3.x, Jon works on v4; Kevin migrates to v4 when it has stabilized.

||= Pros =||= Cons =||
||Kevin can continue learning||Need to maintain separate code repositories for each version||
|| ||Risk of diverging alignment and vision||
|| ||Kevin will have to throw-away / address even more technical debt when he migrates to v4||

== Full Migration
Both Kevin and Jonathan migrate to Godot 4 at the same time, no phased upgrade.

||= Pros =||= Cons =||
||Kevin and Jonathan can integrate immediately||Breaking changes with new alpha release for Kevin's work||
|| ||Lack of tutorials available for Godot 4 front-end (GDScript)||