Improved package documentation.

Added migration section.