added docs #8 & #9