Merge pull request OAI#815 from RobDolinMS/OpenAPI.next

[3.0.md] Add table of contents

Author: fehguy

CONTRIBUTORS.md

@@ -2,5 +2,6 @@
 * 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)

versions/3.0.md

@@ -14,6 +14,61 @@ The OpenAPI Specification defines a set of files required to describe such an AP
 These files can then be used by the Swagger-UI project to display the API and Swagger-Codegen to generate clients in various languages.
 Additional utilities can also take advantage of the resulting files, such as testing tools.
 
+## Table of Contents
+<!-- TOC depthFrom:1 depthTo:3 withLinks:1 updateOnSave:1 orderedList:0 -->
+
+- [OpenAPI Specification](#openapi-specification)
+- [Introduction](#introduction)
+- [Table of Contents](#table-of-contents)
+- [Revision History](#revision-history)
+- [Definitions](#definitions)
+- [Specification](#specification)
+	- [Format](#format)
+	- [File Structure](#file-structure)
+	- [Data Types](#data-types)
+	- [Schema](#schema)
+		- [OpenAPI Object](#openapi-object)
+		- [Info Object](#info-object)
+		- [Host Object](#host-object)
+		- [Contact Object](#contact-object)
+		- [License Object](#license-object)
+		- [Components Object](#components-object)
+		- [Paths Object](#paths-object)
+		- [Path Item Object](#path-item-object)
+		- [Operation Object](#operation-object)
+		- [External Documentation Object](#external-documentation-object)
+		- [Parameter Object](#parameter-object)
+		- [Request Body Object](#request-body-object)
+		- [Content Object](#content-object)
+		- [Content Type Object](#content-type-object)
+		- [Items Object](#items-object)
+		- [Responses Object](#responses-object)
+		- [Response Object](#response-object)
+		- [Headers Object](#headers-object)
+		- [Examples Object](#examples-object)
+		- [Links Object](#links-object)
+		- [Link Object](#link-object)
+		- [Variable substitution](#variable-substitution)
+		- [Link Parameters](#link-parameters)
+		- [Header Object](#header-object)
+		- [Tag Object](#tag-object)
+		- [Examples Object](#examples-object)
+		- [Reference Object](#reference-object)
+		- [Schema Object](#schema-object)
+		- [XML Object](#xml-object)
+		- [Definitions Object](#definitions-object)
+		- [Parameters Definitions Object](#parameters-definitions-object)
+		- [Responses Definitions Object](#responses-definitions-object)
+		- [Security Definitions Object](#security-definitions-object)
+		- [Security Scheme Object](#security-scheme-object)
+		- [Scopes Object](#scopes-object)
+		- [Security Requirement Object](#security-requirement-object)
+	- [Specification Extensions](#specification-extensions)
+	- [Security Filtering](#security-filtering)
+	
+
+<!-- /TOC -->
+
 ## Revision History
 
 Version | Date | Notes