Some discussion

swagger-parsing-format.js

nav: [
  {title: 'Account', href: '/guides/account'}
]

resources: {
 'account': {
  'x-sfdc-ia-resource': 'Account',
  paths : {
    '/AccountList': {
      'get': {
        'x-sfdc-ia-resource': 'Account'
        summary: 'List all the accounts',
        parameters: [
          {
            description: 'Id of AcceptedEventRelation that needs to be fetched'
            in: 'path',
            name: 'Id',
            required: true,
            type: string
          }
        ],
        responses: {
          200: {
            refs: 'Account'
          }
        }
      }
    },
    '/Account/{id}': {
      get: {
        summary: 'Get a single account',
        parameters: {},
      }
    },
    '/Account': {
      post: {
        'x-sfdc-ia-resource': 'Account',
        summary: 'Create an account',
        parameters: {

          // Swagger doesnt have it like this
          url_parameters: {},
          body_parameters: {},
          header_parameters: {}

        },
        responses: {
          200: {
            refs: '/definitions/Customer'
          }
        }
      },
      put: {

      }
    },
  }
  .... all the paths whose resource = 'Account'
}

definition:  {
  Account: {},
  Customer: {}
}