From 0bef16601f087950b0a341fb4790c55bd8b318ef Mon Sep 17 00:00:00 2001 From: "Rob Dolin (MSFT)" Date: Fri, 16 Jun 2017 09:47:07 -0700 Subject: [PATCH 1/5] Create MAINTAINERS.md Create a MAINTAINERS file to align with OAI charter section 4.e. >The maintainers of the TDC shall be those listed in the MAINTAINERS file in the project repository, available in the top level of the code repository. AFAIK, this list represents the current people with access to push the green `Merge` button on the OpenAPI Spec repository --- MAINTAINERS.md | 7 +++++++ 1 file changed, 7 insertions(+) create mode 100644 MAINTAINERS.md diff --git a/MAINTAINERS.md b/MAINTAINERS.md new file mode 100644 index 0000000000..4a2f1256fc --- /dev/null +++ b/MAINTAINERS.md @@ -0,0 +1,7 @@ +* Darrel Miller [@darrelmiller](https://github.com/darrelmiller) +* Jason Harmon [@jharmn](https://github.com/jharmn) +* Jeremy Whitlock [@whitlockjc](https://github.com/whitlockjc) +* Marsh Gardiner [@earth2marsh](https://github.com/earth2marsh) +* Rob Dolin [@RobDolinMS](https://github.com/robdolinms) +* Ron Ratovsky [@webron](https://github.com/webron) +* Tony Tam [@fehguy](https://github.com/fehguy) From 9c2ffda7052e3df19e48325351e63e380b49d005 Mon Sep 17 00:00:00 2001 From: Darrel Date: Fri, 16 Jun 2017 15:04:04 -0400 Subject: [PATCH 2/5] Updating to include TDC maintainers only as per charter --- MAINTAINERS.md | 1 - 1 file changed, 1 deletion(-) diff --git a/MAINTAINERS.md b/MAINTAINERS.md index 4a2f1256fc..5a5ab82e15 100644 --- a/MAINTAINERS.md +++ b/MAINTAINERS.md @@ -2,6 +2,5 @@ * Jason Harmon [@jharmn](https://github.com/jharmn) * Jeremy Whitlock [@whitlockjc](https://github.com/whitlockjc) * Marsh Gardiner [@earth2marsh](https://github.com/earth2marsh) -* Rob Dolin [@RobDolinMS](https://github.com/robdolinms) * Ron Ratovsky [@webron](https://github.com/webron) * Tony Tam [@fehguy](https://github.com/fehguy) From 7baf04ca360ebbf50306b7c5bb6d0e54e8cb295e Mon Sep 17 00:00:00 2001 From: Brendan Abbott Date: Fri, 14 Jul 2017 17:57:10 +1000 Subject: [PATCH 3/5] Update IMPLEMENTATIONS.md Add lincoln and serverless-openapi-documentation projects to the IMPLEMENTATIONS.md --- IMPLEMENTATIONS.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/IMPLEMENTATIONS.md b/IMPLEMENTATIONS.md index 773e2595a9..9bcf75b8ab 100644 --- a/IMPLEMENTATIONS.md +++ b/IMPLEMENTATIONS.md @@ -34,6 +34,7 @@ These tools are not necessarily endorsed by the OAI. | Title | Project Link | Language |Description | |----------------|--------------|----------|---------------------| | openapi-viewer | [GitHub/koumoul/openapi-viewer](https://github.com/koumoul-dev/openapi-viewer) | Vue.js | Browse and test a REST API described with the OpenAPI 3.0 Specification. | +| lincoln | [GitHub/temando/open-api-renderer](https://github.com/temando/open-api-renderer)| React.js| A React renderer for Open API v3 | #### Server Implementations @@ -45,3 +46,4 @@ These tools are not necessarily endorsed by the OAI. |----------------|--------------|----------|---------------------| | baucis-openapi3 | [Github/metadevpro/baucis-openapi3](https://github.com/metadevpro/baucis-openapi3) | Node.js | [Baucis.js](https://github.com/wprl/baucis) plugin for generating OpenAPI 3.0 compliant API contracts. | | Google Gnostic | [GitHub/googleapis/gnostic](https://github.com/googleapis/gnostic) | Go | Compile OpenAPI descriptions into equivalent Protocol Buffer representations. | +| serverless-openapi-documentation | [GitHub/temando/serverless-openapi-documentation](https://github.com/temando/serverless-openapi-documentation) | Typescript | Serverless 1.0 plugin to generate OpenAPI V3 documentation from serverless configuration | From fd658f151cf4adfad57e16de67681ce39b65780e Mon Sep 17 00:00:00 2001 From: Ron Date: Mon, 21 Aug 2017 12:04:16 -0700 Subject: [PATCH 4/5] no more active --- README.md | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/README.md b/README.md index 301161dfb1..01254b3b8c 100644 --- a/README.md +++ b/README.md @@ -4,6 +4,16 @@ ![](https://avatars3.githubusercontent.com/u/16343502?v=3&s=200) + +# Note + +This is not an active work branch anymore but is currently kept around. For details on how to contribute next, review our [Development Guidelines](https://github.com/OAI/OpenAPI-Specification/blob/master/DEVELOPMENT.md). + + + +--- + + The OpenAPI Specification is a community driven, open specification within the [Open API Initiative](https://www.openapis.org/), a Linux Foundation Collaborative Project. The OpenAPI Specification (OAS) defines a standard, programming language-agnostic interface description for REST APIs, which allows both humans and computers to discover and understand the capabilities of a service without requiring access to source code, additional documentation, or inspection of network traffic. When properly defined via OpenAPI, a consumer can understand and interact with the remote service with a minimal amount of implementation logic. Similar to what interface descriptions have done for lower-level programming, the OpenAPI Specification removes guesswork in calling a service. From 79e6e497e0d1172b97475238be834cb753e2d3bd Mon Sep 17 00:00:00 2001 From: Darrel Date: Fri, 10 Nov 2017 13:01:42 -0500 Subject: [PATCH 5/5] Changes as per Ron and Marsh --- MAINTAINERS.md | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/MAINTAINERS.md b/MAINTAINERS.md index 5a5ab82e15..05849e61f5 100644 --- a/MAINTAINERS.md +++ b/MAINTAINERS.md @@ -1,6 +1,9 @@ +## Active * Darrel Miller [@darrelmiller](https://github.com/darrelmiller) -* Jason Harmon [@jharmn](https://github.com/jharmn) * Jeremy Whitlock [@whitlockjc](https://github.com/whitlockjc) * Marsh Gardiner [@earth2marsh](https://github.com/earth2marsh) * Ron Ratovsky [@webron](https://github.com/webron) + +## Emeritus +* Jason Harmon [@jharmn](https://github.com/jharmn) * Tony Tam [@fehguy](https://github.com/fehguy)