adding some examples to the constructor docs