Two issues are being sorted out in this commit:
role developers were not changing the "ROLE NAME" placeholder in README.rst with the actual role name
role names with hyphens or periods were producing invalid variable names in the examples section of README.rst