added docs about updating permissions when migrating