updated docs + fixes