diff --git a/versions/3.1.0.md b/versions/3.1.0.md
index f0c7f54abe..5f78a76e92 100644
--- a/versions/3.1.0.md
+++ b/versions/3.1.0.md
@@ -211,7 +211,8 @@ The metadata MAY be used by the clients if needed, and MAY be presented in editi
Field Name | Type | Description
---|:---:|---
title | `string` | **REQUIRED**. The title of the application.
-description | `string` | A short description of the application. [CommonMark syntax](http://spec.commonmark.org/) MAY be used for rich text representation.
+summary | `string` | A short summary of the application.
+description | `string` | A verbose explanation of the application. [CommonMark syntax](http://spec.commonmark.org/) MAY be used for rich text representation.
termsOfService | `string` | A URL to the Terms of Service for the API. MUST be in the format of a URL.
contact | [Contact Object](#contactObject) | The contact information for the exposed API.
license | [License Object](#licenseObject) | The license information for the exposed API.
@@ -225,6 +226,7 @@ This object MAY be extended with [Specification Extensions](#specificationExtens
```json
{
"title": "Sample Pet Store App",
+ "summary": "A pet store manager.",
"description": "This is a sample server for a pet store.",
"termsOfService": "http://example.com/terms/",
"contact": {
@@ -242,6 +244,7 @@ This object MAY be extended with [Specification Extensions](#specificationExtens
```yaml
title: Sample Pet Store App
+summary: A pet store manager.
description: This is a sample server for a pet store.
termsOfService: http://example.com/terms/
contact: