Adds links that point to the API contrib guidelines to repo docs.

Author: szabosteve

README.md

@@ -83,6 +83,10 @@ An interactive viewer for the Elasticsearch specification is available
 
 See [CONTRIBUTING.md](./CONTRIBUTING.md)
 
+Refer to the
+[Contributie to Elastic API docs](https://www.elastic.co/docs/extend/contribute/api-docs/)
+for more details about the API documentation guidelines.
+
 ## Make Targets
 
 ```

docs/add-new-api.md

@@ -5,6 +5,10 @@ in this repository, or we do have an endpoint definition in [`/specification/_js
 but we don't have a type definition for it.
 In this document you will see how to add a new endpoint and how to add a new endpoint definition.
 
+Refer to the
+[API docs contribution guidelines](https://www.elastic.co/docs/extend/contribute/api-docs/)
+to learn more about how to craft great docs for your API.
+
 ## How to add a new endpoint
 
 Add a new endpoint is straightforward, you only need to copy-paste the json rest-api-spec definition

docs/doc-comments-guide.md

@@ -5,7 +5,7 @@ A specification is not only about formalizing data structures, it's also about e
 Documentation of the TypeScript specification is made using [JSDoc](https://jsdoc.app/) comments, i.e. multiline comments starting with `/**` above a type or field declaration.
 
 The first phrase is used as the mandatory operation summary in the OpenAPI document.
-Refer to [API documentation guidelines](https://docs.elastic.dev/content-architecture/oas#summaries).
+Refer to the [API docs contribution guidelines](https://www.elastic.co/docs/extend/contribute/api-docs/guidelines) to learn more about how to create great documentation for your API.
 
 > [!NOTE] 
 > You must add a period at the end of the phrase for it to parse correctly. The period will be properly omitted from the output OpenAPI document.
@@ -76,6 +76,8 @@ GFM also has implementations in most languages, meaning that code generators wil
 
 ## Structuring a doc-comment
 
+For guidelines of how to write great doc-comments, refer to the [Contribute to API docs](https://www.elastic.co/docs/extend/contribute/api-docs/guidelines#write-descriptions) page.
+
 ### Terseness
 
 **Doc comments are reference material**: they should be as succinct as possible while capturing all the necessary information to use the elements they're documenting. Remember that they will often show up in small IDE autocompletion popups!

docs/modeling-guide.md

@@ -9,7 +9,7 @@ the basic types [here](https://www.typescriptlang.org/docs/handbook/basic-types.
 while in [behaviors](./behaviors.md) you can find the list of special interfaces used
 for describing APIs that can't be represented in the specification.
 
-Refer to the [documentation guide](doc-comments-guide.md) to add documentation to types and fields.
+Refer to the [API docs contribution guidelines](https://www.elastic.co/docs/extend/contribute/api-docs/) to add documentation to types and fields.
 
 ### Dictionary
 

docs/schema-structure.md

@@ -9,7 +9,7 @@ the basic types [here](https://www.typescriptlang.org/docs/handbook/basic-types.
 while in [behaviors](./behaviors.md) you can find the list of special interfaces used
 for describing APIs that can't be represented in the specification.
 
-Refer to the [documentation guide](doc-comments-guide.md) to add documentation to types and fields,
+Refer to the [API docs contributon guidelines](https://www.elastic.co/docs/extend/contribute/api-docs/) to add documentation to types and fields,
 and to the [modeling guide](modeling-guide.md) to learn how to model the different types.
 
 You can find the schema representing all APIs and types in the [output folder](output/schema/schema.json).