Cleanup README and add further spec details (#2)