version 1.0, now with much needed commentary