docs updated; examples simplified