ensure swagger feature is self-contained so can be easily reference outs...

...ide