updated docs and references