adds markdown examples
upstream merge
example order