Documentation improvements + addd optional parameter