review

Author: shortcuts

website/docs/contributing/add-new-api-client.md

@@ -58,12 +58,12 @@ Path definition of the paths defined in the [spec file](#specyml-file). See [gui
 
 > [Detailed issue](https://github.com/algolia/api-clients-automation/issues/891)
 
-In some cases, you can encounter wrongly named `requestBody` from the specs, which is due to:
+In some cases, you can encounter wrongly named `requestBody` from the specs, which could be due to:
 
 - The type is too complex/too broad to be generated. (e.g. [An object with `additionalProperties`](https://github.com/algolia/api-clients-automation/tree/main/specs/search/paths/objects/partialUpdate.yml#L24-L33))
-- The body is an alias of its sub type (e.g. [A list of sub models](https://github.com/algolia/api-clients-automation/tree/main/specs/search/paths/rules/saveRules.yml#L12-L20))
+- The type is an alias of its model (e.g. [A list of `model`](https://github.com/algolia/api-clients-automation/tree/main/specs/search/paths/rules/saveRules.yml#L12-L20))
 
-The `x-codegen-request-body-name` property can be added at the root of the spec, to force the name of the generated `requestBody` property.
+The [`x-codegen-request-body-name`](https://openapi-generator.tech/docs/swagger-codegen-migration/#body-parameter-name) property can be added at the root of the spec, to force the name of the generated `requestBody` property.
 
 You can find an example of this implementation [on this PR](https://github.com/algolia/api-clients-automation/pull/896).