Provide some guidance on setting up variables

See merge request !3

Update guideline ordering and align with public modules

See merge request !2

This includes addition of repo naming guidelines, more
clarification around the expected files, and an update to the
sample readme to add type, default, and required values for inputs

initial attempt

See merge request !1