wrote docs for functions starting with "O"