added documentation on heat api's validate template response

this change documents the response returned by the heat api validate
template endpoint.

Change-Id: Iebe2bfaf46907fdde655f5ce19ae560e1e559030
Closes-Bug: 1367055
Merge "added documentation on heat api's validate template response"