ID#234: added migration documentation.
Code clean-up.