added docs and paring