Improvements to the first half of the integration doc