docs update

docs rev + bug fix