some docs and specs