adds example
improves docs