add generation and migration notes