more idl docs cleanup

slightly prettier docs from the idl