Add comments to ks for clarification; update README.