documented and refactored to facilitate headless feature file generation