changes in examples, changes in layout, docs on best practices