update docs (describe theta)