adding auto-generated file README.rst solely to make github happy.
progress-tracking commit. things meed much refactoring.