add comments+defaults to all specs of factories