Bug 1226227

Documentation URL: https://access.redhat.com/documentation/en-US/Red_Hat_Satellite/6.0/html/Provisioning_Guide/chap-Red_Hat_Satellite-Provisioning_Guide-Finalizing_Provisioning_Configuration.html

Section Number and Name: Somewhere around "Chapter 5. Finalizing Provisioning Configuration"

Describe the issue: This chapter of the documentation does not provide enough detail on precisely how to create provisioning template. In particular, it does not describe how provisioning templates are constructed, and how the Ruby template IF conditions work. 

The severity of this is that new customers with Satellite 6 have to "reverse engineer" the existing templates, and many of these users are systems adminstrators WITHOUT many scripting skills. 

A real customer example here is a large global SI, who are trying to deploy Satellite 6 in to 5 different environments simultaneously. This requires some considerable customization of the provisioning templates, and the engineers are having a hard time working out what variables and statements are available in-context.

Suggestions for improvement: If we want to encourage our partners to use this area of Satellite (and we really do), then adequate documentation is necessary. 

Additional information: No public training courses are available for Satellite 6 yet, which is why it's so essential that the documentation is adequate to help customers up until this point.