These changes and improvements have been added to the upstream documentation. They are helpful and better than what we had previously.
https://github.com/eclipse/che-docs/pull/657

We should update our current 1.2 documentation with the information that have been added upstream.