example update
improved header documentation and some cleaning up