added docs and specs