more commentary and documentation