add more examples and cleanup some headings