create table resources (
  type text not null,
  plural text not null,
  path text,
  description text,
  deprecation ,
  operations ,
  attributes 
);

comment on column resources.type is '
  The type of this resource will map to a defined model, enum, or union type
';
comment on column resources.path is '
  The path to this specific resource. This was added in 2016 to help us differentiate between the resource path and the operation path which can be helpful when, for example, generating method names for operations. This field is optional as some of our input formats (e.g. swagger) do not explicitly differentiate resoure paths.
';