update docs and specs