As integration is a key differentiator for Magnolia, developers should be able to get an understanding of their options for integrating, and discover why Magnolia is a good choice for integration.
It should be as easy as possible for them to discover the best technique to solve their integration requirement. And the docs should provide the guidance they need to perform their integration.
Ideally it would also help them understand the relative effort, and skill set to implement a specifc kind of integration. (20 minutes of configuration vs 4 weeks of Java dev for a custom connector)
Integration on Magnolia Cloud should be specifically addressed, and is the top priority.
Integration with "Integration platforms" should be specifically addressed.
We already have https://documentation.magnolia-cms.com/display/DOCS56/Integration which is a good starting point.
Some Ideas for Integration on Cloud: https://wiki.magnolia-cms.com/display/PMTEAM/Integration+options+for+Magnolia+Cloud