updated docs for 1b