not sure how the openapi renderer is going to feel about this, but maybe
better than it felt about what was there before?