misc updates
better examples