diff --git a/specification/paths.md b/specification/paths.md index 175af00..381f6e8 100644 --- a/specification/paths.md +++ b/specification/paths.md @@ -39,7 +39,7 @@ paths: ## The Path Item Object -The [Path Item Object](https://spec.openapis.org/oas/v3.1.0#path-item-object) describes the HTTP operations that can be performed on a path with a separate [Operation Object](https://spec.openapis.org/oas/v3.1.0#operation-object) for each one. Allowed operations match HTTP methods names like `get`, `put` or `delete`, to list the most common (find the complete list in the [Path Item Object](https://spec.openapis.org/oas/v3.1.0#path-item-object) specification). +The [Path Item Object](https://spec.openapis.org/oas/v3.1.0#path-item-object) describes the HTTP operations that can be performed on a path with a separate [Operation Object](https://spec.openapis.org/oas/v3.1.0#operation-object) for each one. Allowed operations match HTTP method names like `get`, `put` or `delete`, to list the most common (find the complete list in the [Path Item Object](https://spec.openapis.org/oas/v3.1.0#path-item-object) specification). This object also accepts common properties for all operations on the path like `summary` or `description`. The details of each operation are given in each child Operation object. diff --git a/specification/structure.md b/specification/structure.md index c585534..cf87a14 100644 --- a/specification/structure.md +++ b/specification/structure.md @@ -107,7 +107,7 @@ This API is not very useful because it **defines no operations** (it has no endp This page has shown that: * The syntax (language) used to write OpenAPI Descriptions can be **JSON**, **YAML** or **both**. -* An OpenAPI Descriptions is a JSON object including the fields described in the [OpenAPI Specification](https://spec.openapis.org/oas/v3.1.0). +* An OpenAPI Description is a JSON object including the fields described in the [OpenAPI Specification](https://spec.openapis.org/oas/v3.1.0). * Every OpenAPI Descriptions must contain an OpenAPI Object with at least the fields `openapi`, and `info`, and either `paths`, `components` or `webhooks`. [The following page](paths) describes the contents of the `paths` field so endpoints can be added to the above minimal snippet.