Update README of 'secret' role

Added warning about potential leak of sensitive data via Ansible
variables and cosmetic changes to the formatting of code blocks.