some commentary and params