Merge branch 'main' of github.com:elastic/elasticsearch-specification into ml-inference-task-type-separation

Author: jonathan-buttner

.github/validate-pr/index.js

@@ -53,7 +53,7 @@ async function run () {
       per_page: 100
     })
     if (data.length > 0) {
-      files.push(...data.map(entry => entry.filename))
+      files.push(...data.filter(entry => entry.status !== 'deleted').map(entry => entry.filename))
       page += 1
     } else {
       break

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-serverless-openapi.json" "docs/overlays/elasticsearch-serverless-openapi-overlays.yaml" > "output/openapi/elasticsearch-serverless-openapi.tmp1.json"
 	@npx bump overlay "output/openapi/elasticsearch-serverless-openapi.tmp1.json" "docs/overlays/elasticsearch-shared-overlays.yaml" > "output/openapi/elasticsearch-serverless-openapi.tmp2.json"
@@ -78,6 +76,8 @@ lint-docs-errs: ## Lint the OpenAPI documents after overlays and return only err
 lint-docs-serverless: ## Lint only the serverless OpenAPI document after overlays
 	@npx @stoplight/spectral-cli lint output/openapi/elasticsearch-serverless-openapi.examples.json --ruleset .spectral.yaml
 
+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> --------------

README.md

@@ -305,7 +305,7 @@ If you are using MacOS, run the following command to fix the issue:
 brew install coreutils
 ```
 
-### I need to modify che compiler, help!
+### I need to modify the compiler, help!
 
 Take a look at the [compiler documentation](./docs/compiler.md).
 

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 {