ENH: updated comments, default yamls, code