Docs template
Update README
Improve spec descriptions