documentation improvement
migration changes for large installations