Updates the migration document with ammendments from Bill