rename delta file and update transition docs

Dirty PR for review.  Requires #6074, may show merge conflict.