fixes to README (list, markdown, details); closes #26