Microsoft have published new documentation on using ARM templates. https://docs.microsoft.com/en-us/azure/templates/   First impressions of this new documentation are good