fixed markdown errors, updated for clarity