updated docs for using examples
fix some documentation and touch up some key processing code