Merge branch '8.x' into backport-3589-to-8.x

Author: lcawl

Makefile

@@ -57,8 +57,6 @@ filter-for-serverless: ## Generate the serverless version from the compiled sche
 dump-routes: ## Create a new schema with all generics expanded
 	@npm run dump-routes --prefix compiler
 
-contrib: | generate license-check spec-format-fix transform-to-openapi filter-for-serverless ## Pre contribution target
-
 overlay-docs: ## Apply overlays to OpenAPI documents
 	@npx bump overlay "output/openapi/elasticsearch-openapi.json" "docs/overlays/elasticsearch-openapi-overlays.yaml" > "output/openapi/elasticsearch-openapi.tmp1.json"
 	@npx bump overlay "output/openapi/elasticsearch-openapi.tmp1.json" "docs/overlays/elasticsearch-shared-overlays.yaml" > "output/openapi/elasticsearch-openapi.tmp2.json"
@@ -71,6 +69,8 @@ lint-docs: ## Lint the OpenAPI documents after overlays
 lint-docs-errs: ## Lint the OpenAPI documents after overlays and return only errors
 	@npx @stoplight/spectral-cli lint output/openapi/elasticsearch-*.examples.json --ruleset .spectral.yaml -D
 
+contrib: | generate license-check spec-format-fix transform-to-openapi filter-for-serverless lint-docs-errs ## Pre contribution target
+
 help:  ## Display help
 	@awk 'BEGIN {FS = ":.*##"; printf "Usage:\n  make \033[36m<target>\033[0m\n"} /^[a-zA-Z_-]+:.*?##/ { printf "  \033[36m%-15s\033[0m %s\n", $$1, $$2 } /^##@/ { printf "\n\033[1m%s\033[0m\n", substr($$0, 5) } ' $(MAKEFILE_LIST)
 #------------- <https://suva.sh/posts/well-documented-makefiles> --------------

docs/modeling-guide.md

@@ -577,6 +577,7 @@ class Foo {
 
 The server side default value if the property is not specified.
 Default values can only be specified on optional properties.
+They appear in the generated documentation and do not affect clients.
 
 ```ts
 class Foo {

docs/overlays/elasticsearch-shared-overlays.yaml

@@ -170,6 +170,11 @@ actions:
       # S
         - name: script
           x-displayName: Script
+          description: >
+            Use the script support APIs to get a list of supported script contexts and languages.
+            Use the stored script APIs to manage stored scripts and search templates.
+          externalDocs:
+            url: https://www.elastic.co/guide/en/elasticsearch/reference/master/modules-scripting.html
         - name: search
           x-displayName: Search
         - name: search_application