better comments and unit tests for initial refactor of feature meta functions