refs #7: update note
refs #7: fixed formatting and added an update note