Talk:OpenAPI Specification

Product Sheet
This reads more like a product sheet than an article talking about what it does and how. Like it was written by a marketing team from salesforce/mulesoft. It does cool stuff and slices your bread. — Preceding unsigned comment added by 104.245.226.203 (talk) 02:51, 22 June 2020 (UTC)

Joke?
Is this a joke?
 * No, RESTful APIs have had a problem of no standard documentation format. Swagger attempts to address this problem. Ebeisher (talk) 22:01, 5 January 2015 (UTC)


 * The article is incorrect (unfortunately, 99% of the world misuses the term REST --> Richardson Maturity Model). Proper REST does not need additional documentation. Therefore you should replace REST with JSON API. Michel.reuteler (talk) 13:19, 27 September 2022 (UTC)

Renaming; it is not much of "science"
Swagger is an API description language and a set of software tools for working with that language. This article should be IMO titled "Swagger (software)". — Preceding unsigned comment added by TvojaStara (talk • contribs) 11:46, 14 March 2015 (UTC)
 * I think it is appropriate that the page was moved back to "OpenAPI Specification". The spec is now owned, authored and implemented by many companies beside Swagger, as documented at https://openapis.org/.  ★NealMcB★ (talk) 23:34, 21 April 2016 (UTC)

Wordnik
I have removed references to Wordnik, as I could not find a reliable source that documents its involvement. However, after some research, I found a mention on the Tony Tam's (creator of Swagger) LinkedIn Page.

"Wordnik was the creator of the Swagger UI for http://developer.wordnik.com which has become the de-facto technology for REST APIs."

However, LinkedIn page is not a reliable source. If anyone can find a reliable source, please amend the article accordingly.

 Kinkreet ~&#9829;moshi moshi&#9829;~ 11:12, 19 October 2017 (UTC)


 * Here is link to initial version of "Swagger-UI" README.md that have Wordnik copyright in it https://github.com/swagger-api/swagger-ui/blob/f126a73d9923de3c5eac5ada99601a745bf19e92/README.md#license Ivan Goncharov (talk) 09:49, 27 November 2017 (UTC)

Neutral point of view issues/promotional tone
Sponsored by SmartBear Software, Swagger has been a strong supporter of open-source software, and has widespread adoption.

--Tuxayo (talk) 02:52, 1 July 2020 (UTC)

Ankward sentence
The following sentence seems to be incorrectly structured.

80.112.158.40 (talk) 07:01, 7 November 2023 (UTC)


 * Agreed! I've edited to improve it (hopefully). Marsh (talk) 21:34, 27 November 2023 (UTC)