At the moment we don't have documentation beyond this knowledgebase article on how to debug an application that fails to deploy.
We're working on some tools in the CLI that will make this easier so we can wait until those are implemented before writing more documentation. This ticket is here to track that.
These scenarios can happen:
+ User tries to install a package with a bad configuration, it never deploys (see DCOS-597).
+ User tries to install a package that requires more resources than the cluster has available.
+ User's Marathon app doesn't deploy