additional future examples info
minor clean up