Expanded README.md and known-issues.txt

Plus a template fix.