1. README.rst:
 a. link review summary to give it more visibility
 b. some formatting to improve readability

2. review summary:
 a. rst formatted to improve readability
 b. added note about escape sequences and variable declaration location