rewrite README to follow outline, fixes #19