OAI / OpenAPI-Specification

Examples table with confusing notes Minor Change

#2088 opened Jan 7, 2020 by hrennau

1

discussion: Semantic validation checklist 2.0 3.0.1 Documentation Meta Issue

#1936 opened May 29, 2019 by whitlockjc

2

Support discovering OpenAPI document from `Link` header?

#2128 opened Feb 7, 2020 by evankanderson

3

Tutorial content ideas for helping users migrate to OAS 3.1

#2095 opened Jan 9, 2020 by darrelmiller

1

Feature suggestion: Links defined the inverse of the way they are currently

#2196 opened Apr 6, 2020 by anentropic

1

No documentation for the "properties" object schema-object

#2001 opened Sep 8, 2019 by Sebi2020

6

Documentation for OpenAPI's Header Object should be verbose

#1965 opened Jun 29, 2019 by shockey

Callback object example has excess key

#1895 opened Apr 16, 2019 by agarb7

RFC 5785 conventions & suggested OpenAPI document locations

#1851 opened Feb 27, 2019 by shockey

5

Provide guidance on Markdown table syntax

#1867 opened Mar 15, 2019 by shockey

2

parameters as a list

#1841 opened Feb 18, 2019 by bjne

3

Use semicolon(;) in Path Parameters review

#1710 opened Oct 15, 2018 by amirmasud

3

Clarify: "type": "string", "format": "binary" in non-entity-body schema-object

#1544 opened Apr 13, 2018 by pbryan

1

Doc improvements: query formats

#1663 opened Aug 13, 2018 by KES777

4

Clarify statement about `Reference obects` in `Responses object` $ref

#1679 opened Aug 31, 2018 by ricellis

3

Add example/s as "Operation Request" child

#1673 opened Aug 22, 2018 by chatelao

1

Should we have more schema examples? Documentation

#1005 opened Mar 24, 2017 by ePaul

8

Using Links to set a field in the target operation's request body

#1594 opened May 31, 2018 by jonathann92

4

[oas3] Default 'explode' for cookie parameters?

#1528 opened Apr 6, 2018 by jwalton

14

Aggregating the Web-Services from Swagger API documentation

#1492 opened Feb 19, 2018 by sayakpaul

1

Explain the term "schema" in definition section

#1423 opened Dec 4, 2017 by agnat

1

wiki: broken link Documentation

#860 opened Jan 11, 2017 by activedecay

2

Documentation of multipart/form-data question

#1487 opened Feb 12, 2018 by vsabadosh

1

Allow recursive paths

#1382 opened Oct 19, 2017 by dstovall

7

Add reference section Documentation

#732 opened Jul 12, 2016 by dret

Unable to add multiple operations on same path in swagger rest API documentation

#1378 opened Oct 17, 2017 by saranyavinayagam

1

Identification of resources

#1318 opened Aug 15, 2017 by gentlewind

2

[Meta Issue] Documentation cleanup Documentation Meta Issue

#700 opened May 19, 2016 by webron

Documentation improvements: Tutorials and FAQs Documentation OpenAPI.Next Proposal Sub Issue

#683 opened May 8, 2016 by arno-di-loreto

1

api-with-examples.yaml: `example` vs `examples` in Media Type Object 3.0.0-RC2

#1116 opened May 19, 2017 by tfesenko

3

Clarify or remove language about "conflicts" in Path Item Object $ref property $ref

#1038 opened Apr 12, 2017 by tedepstein

6

Extend V3 "examples" spec to include names (or IDs) and more data

#1265 opened Jul 12, 2017 by rprieto

1

Question: OpenAPI tools Documentation

#691 opened May 11, 2016 by Vanuan

1

Clarify if JSON References are restricted to properties that explicitly allow them

#1037 opened Apr 12, 2017 by tedepstein

5

More and complete examples for serialization styles

#1288 opened Jul 22, 2017 by slinkydeveloper

15

Linking API to OpenAPI and documentation

#724 opened Jul 4, 2016 by dret

21

2 to 3 migration guide

#869 opened Jan 26, 2017 by ritch

10

Provide example API definition that uses all features of the API. Documentation

#441 opened Aug 14, 2015 by atheken

1

[Meta Issue] Specification documentation structure and supporting docs Meta Issue OpenAPI.Next Proposal

#589 opened Mar 1, 2016 by webron

4

Document errors that could occur within 4xx/5xx OpenAPI.Next Proposal Sub Issue

#567 opened Feb 16, 2016 by jharmn

12

Allow documenting HATEOAS APIs (pathless operation / interface / URI class / operation type) OpenAPI.Next Proposal Sub Issue

#577 opened Feb 22, 2016 by ePaul

69

[Meta issue] Improve error handling/documentation OpenAPI.Next Proposal

#566 opened Feb 16, 2016 by jharmn

1

Create a 'Best Practices' wiki page Documentation OpenAPI.Next Proposal Sub Issue

#122 opened Sep 21, 2014 by webron

8

Improve explanation of Reference Object $ref

#388 opened Jun 5, 2015 by jharmn

38

Meaning of the term API in the operationId context.

#381 opened May 27, 2015 by bachp

10

Add "descriptions" fixed field to Swagger Object OpenAPI.Next Proposal

#368 opened May 19, 2015 by adpextwindong

2