reverb/swagger-spec

Issues

• Create a 'Best Practices' wiki page

  #99 opened 10 years ago by webron
  2

• Clarify goals in spec documentation

  #100 opened 10 years ago by webron
  1

• Need a way to accommodate reusable YAML without violating schema or cluttering JSON

  #107 opened 10 years ago by earth2marsh
  36

• add examples

  #62 opened 10 years ago by fehguy
  9

• add examples with remote model references

  #83 opened 10 years ago by fehguy
  1

• Accommodate legacy APIs by allowing query parameters in the path

  #84 opened 10 years ago by earth2marsh
  6

• Use of URI format

  #88 opened 10 years ago by maxlinc
  10

• add enum for collectionFormat

  #103 opened 10 years ago by fehguy
  4

• Lost Resource Description

  #106 opened 10 years ago by webron
  10

• Restrict pathItem's $ref type

  #111 opened 10 years ago by webron
  1

• Add a more strict constraint for "items" in the parameter object.

  #112 opened 10 years ago by webron
  1

• Add `deprecated` field on the Operation Object

  #115 opened 10 years ago by webron
  1

• Changes to the Example Object

  #116 opened 10 years ago by webron
  2

• Reference serializableType from parameter object

  #117 opened 10 years ago by webron
  1

• Implicit Path Parameters

  #120 opened 10 years ago by jewest27
  7

• Missing 'body' from parameter type

  #121 opened 10 years ago by earth2marsh
  2

• modelsWithExamples contains no "example"

  #124 opened 10 years ago by webron
  1

• Security schema is under-developed

  #126 opened 10 years ago by earth2marsh
  2

• Clarify release procedure for Swagger spec v 2.0

  #129 opened 10 years ago by vlcinsky
  3

• xml attribute needed on schema

  #125 opened 10 years ago by fehguy
  6

• JSON Schema for v1.2 API Declaration authorizations is wrong

  #118 opened 10 years ago by whitlockjc
  1

• Missing operationId in v2.0/json/petstore.json

  #119 opened 10 years ago by raymondfeng
  1

• Default response definitions clutter a spec

  #122 opened 10 years ago by earth2marsh
  3

• [2.0] What's the purpose of definitions in a schema entry

  #127 opened 10 years ago by whitlockjc
  0

• externalDocs should be renamed to externalDoc

  #109 opened 10 years ago by webron
  9

• Make the "description" of "externalDocs" optional

  #113 opened 10 years ago by webron
  0

• Potential naming mismatch: 'schemas' refer to 'definitions'

  #108 opened 10 years ago by earth2marsh
  1

• Possible issue with schema's pathItem - minimum properties

  #105 opened 10 years ago by webron
  1

• Parameters explicitly define names rather than enumerate them

  #104 opened 10 years ago by earth2marsh
  3

• consider multiple examples per media type

  #93 opened 10 years ago by fehguy
  1

• enhance security examples

  #102 opened 10 years ago by fehguy
  1

• Add format limitations to paths

  #101 opened 10 years ago by webron
  0

• Add docsUrl throughout schema

  #97 opened 10 years ago by fehguy
  1

• Examples vs samples?

  #77 opened 10 years ago by maxlinc
  10

• Relative hosting

  #56 opened 10 years ago by paulhill
  6

• update host to disallow scheme (transport)

  #82 opened 10 years ago by fehguy
  4

• mediatype regex is too restrictive

  #91 opened 10 years ago by fehguy
  0

• both produces and consumes should cascade

  #92 opened 10 years ago by fehguy
  0

• specify MD flavor for descriptions

  #94 opened 10 years ago by fehguy
  0

• add name attribute for XML representation

  #95 opened 10 years ago by fehguy
  0

• revisit `schemas` for location of model defintions

  #81 opened 10 years ago by fehguy
  21

• simplify parameter specification for query, header, cookie params

  #74 opened 10 years ago by fehguy
  3

• default to something other than api-docs

  #66 opened 10 years ago by fehguy
  3

• schemes should cascade to an operation

  #73 opened 10 years ago by fehguy
  1

• add XML format hints to model properties

  #63 opened 10 years ago by fehguy
  1

• using "schema" for defining a data type looks weird

  #64 opened 10 years ago by fehguy
  4

• Models vs Schemas

  #69 opened 10 years ago by earth2marsh
  3

• add example with discriminator

  #67 opened 10 years ago by fehguy
  1

• add `tags` optional array at operation level

  #65 opened 10 years ago by fehguy
  0

• Allow parameters on the path object

  #50 opened 10 years ago by fehguy
  1