add some examples and markdown markup