feat: extend node types with description

.changeset/lovely-mice-slide.md

@@ -0,0 +1,6 @@
+---
+"@redocly/openapi-core": patch
+---
+
+Added `description` and `documentationLink` properties to NodeTypes.
+Renamed Redocly configuration types to better reflect their purpose and relations.

docs/@v1/rules/configurable-rules.md

@@ -24,7 +24,7 @@ A configurable rule describes the contents that the linter expects to find in yo
 | ---------- | ------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | subject    | [Subject object](#subject-object)     | **REQUIRED.** Locates the specific [OpenAPI node type](#subject-node-types-and-properties) or `any` (see [example](#any-example)) and possible properties and values that the [lint command](../commands/lint.md) evaluates. Use with `where` to narrow further.                                                                                                                                                                                                                                                                             |
 | assertions | [Assertion object](#assertion-object) | **REQUIRED.** Flags a problem when a defined assertion evaluates false. There are a variety of built-in assertions included. You may also create plugins with custom functions and use them as assertions.                                                                                                                                                                                                                                                                                                                                   |
-| where      | [Where object](#where-object)         | Narrows subjects by evaluating the where list first in the order defined (from top to bottom). The resolution of reference objects is done at the `where` level. See [where example](#where-example). The `where` evaluation itself does not result in any problems.                                                                                                                                                                                                                                                                         |
+| where      | [[Where object](#where-object)]       | Narrows subjects by evaluating the where list first in the order defined (from top to bottom). The resolution of reference objects is done at the `where` level. See [where example](#where-example). The `where` evaluation itself does not result in any problems.                                                                                                                                                                                                                                                                         |
 | message    | string                                | Problem message displayed if the assertion is false. If omitted, the default message is: "{{assertionName}} failed because the {{subject}} {{property}} didn't meet the assertions: {{problems}}" is displayed. The available placeholders are displayed in that message. In the case there are multiple properties, the `{{property}}` placeholder produces a comma and space separate list of properties. In case there are multiple problems, the `{{problems}}` placeholder produces a bullet-list with a new line between each problem. |
 | suggest    | [string]                              | List of suggestions to display if the problem occurs.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
 | severity   | string                                | Configure the severity level of the problem if the assertion is false. It must be one of these values: `error`, `warn`, `off`. Default value is `error`.                                                                                                                                                                                                                                                                                                                                                                                     |

docs/@v2/rules/configurable-rules.md

@@ -24,7 +24,7 @@ A configurable rule describes the contents that the linter expects to find in yo
 | ---------- | ------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | subject    | [Subject object](#subject-object)     | **REQUIRED.** Locates the specific [OpenAPI node type](#subject-node-types-and-properties) or `any` (see [example](#any-example)) and possible properties and values that the [lint command](../commands/lint.md) evaluates. Use with `where` to narrow further.                                                                         |
 | assertions | [Assertion object](#assertion-object) | **REQUIRED.** Flags a problem when a defined assertion evaluates false. There are a variety of built-in assertions included. You may also create plugins with custom functions and use them as assertions.                                                                                                                               |
-| where      | [Where object](#where-object)         | Narrows subjects by evaluating the where list first in the order defined (from top to bottom). The resolution of reference objects is done at the `where` level. See [where example](#where-example). The `where` evaluation itself does not result in any problems.                                                                     |
+| where      | [[Where object](#where-object)]       | Narrows subjects by evaluating the where list first in the order defined (from top to bottom). The resolution of reference objects is done at the `where` level. See [where example](#where-example). The `where` evaluation itself does not result in any problems.                                                                     |
 | message    | string                                | Custom text displayed when an assertion fails. Placeholders can be used to include contextual information such as the rule name, object type, property, error location, and problems. See [Using message placeholders](#use-placeholders-in-messages) and [List of available placeholders](#list-of-available-placeholders) for details. |
 | suggest    | [string]                              | List of suggestions to display if the problem occurs.                                                                                                                                                                                                                                                                                    |
 | severity   | string                                | Configure the severity level of the problem if the assertion is false. It must be one of these values: `error`, `warn`, `off`. Default value is `error`.                                                                                                                                                                                 |