Apply suggestions from code review

Co-authored-by: Ralf Handl <[email protected]>

Author: lornajane

overlay/example-add-filter-parameters.md

@@ -38,7 +38,7 @@ actions:
       - x-filters-added
 ```
 
-You can adjust the target expression to apply only to certain paths or methods, or use another approach to identify which operations should be used.
+You can adjust the target expression to apply only to certain paths or methods, or use another approach to identify which operations should be updated.
 
 It might be more elegant to first update the `components.parameters` section of an OpenAPI description to add the parameters there, and then refer to those new entries when updating the existing operations.
 The Overlay Specification requires that each action is processed in the order it is seen in the Overlay document.

overlay/example-add-license.md

@@ -11,7 +11,7 @@ has_toc: false
 Every API needs a license so people know they can use it, but what if your OpenAPI descriptions don't have a license?
 This example shows an Overlay that adds a license to an OpenAPI description.
 
-Here's here's the overlay file, with just one action to add or change the `info.license` fields:
+Here's the Overlay file, with just one action to add or change the `info.license` fields:
 
 ```yaml
 overlay: 1.0.0

overlay/index.md

@@ -9,7 +9,7 @@ has_toc: false
 # Introduction to OpenAPI Overlay Specification
 
 The [Overlay Specification](https://spec.openapis.org/overlay/latest.html) defines a document format for information that transforms an existing OpenAPI description yet remains separate from the OpenAPI description's source document(s).
-The goal of the Overlay Specification is to provide a mechanism for providing consistent, deterministic updates to a given OpenAPI description, as an aid to automation throughout the API lifecycle.
+The Overlay Specification defines a mechanism for providing consistent, deterministic updates to a given OpenAPI description, as an aid to automation throughout the API lifecycle.
 
 An Overlay can be applied to an OpenAPI description, resulting in an updated OpenAPI description.