some small commentary updates