documented the more functional api I would like in the struct tests