Readme with usage/notes details on template rendering

Readme driven development.  This outlines some details and special
notes on how to define/render templates.  This is the spec that
will be implemented.

@jcredding ready for review.