add a migration doc enabling people to use the new join scripts flow

[talalashraf]

we have decoupled account management from the scripts and we want to allow people to migrate from the old scripts to the new ones. the migration would involve folder structure changes.

we want to improve documentation. take logic away from the scripts if there is potential for more and we should improve docs to explain exactly what the scripts are doing.