updated some commentary