more minor tweaks and notes