fix(tests): integration improvements and documentation

This includes several changes to assumptions made by the integration tests as well as documentation describing how to use them.