The automated mechanism that attempts to optimise the integration scheme to deal with narrow resonances, etc. handles most situations very well but it doesn't work perfectly in every scenario. In such cases some manual intervention is required. It is s very tricky issue and perhaps needs some dedicated documentation to explain how the automated mechanism works, what are the potential pitfalls, how to detect a problem, how to tweak the available parameters to fix things, etc.
For pieces of technical documentation like this we could simply create a note or some slides to be uploaded somewhere as a pdf file but it might be better to either use the wiki functionality of Phabricator to create pages on particular topics or try to create some topic pages in the Doxygen documentation - to be seen which approach or combination of approaches works best.