code: function generateResourceListing (options) {
    var controllers = options.controllers;
    var opts = options.options || {};
    
    var paths = buildPaths(controllers);
    var definitions = buildDefinitions(controllers);
  
    var listing = {
      swagger: '2.0',
      info: {
        description: 'Baucis generated API',
        version: options.version,
        title: 'api',
        //termsOfService: 'TOS: to be defined.',
        //contact: { 
        //  email: 'me@address.com' 
        //},
        //license: {
        //  name: 'TBD',
        //  url: 'http://license.com'
        //}
      },
      //host: null, 
      basePath: options.basePath,
      tags: buildTags(options),
      schemes: ['http', 'https'],
      consumes: ['application/json'],
      produces: ['application/json', 'text/html'],
      paths: paths,
      definitions: definitions,
      parameters: params.generateCommonParams()
      //responses: getReusableResponses(),
      //securityDefinitions: {},
      //security: []  // Must be added via extensions
      //externalDocs: null
    };
    
    if (opts.security) {
      listing.security = opts.security;	  
    }
    if (opts.securityDefinitions) {
      listing.securityDefinitions = opts.securityDefinitions;	  
    }
  
    return listing;
  }
docs: A method for generating a Swagger resource listing