updated docs (still in progress)