added examples and tweaked formatting