updated README.rst for latest code changes and improved rules formatting and text