Add documentation for Role Variables to the Best Practices page

This also fixes a few minor typos.