docs: update sidebar and built-in rules documentation

Author: vadyvas

docs/@v2/rules/built-in-rules.md

@@ -142,11 +142,11 @@ Within the Arazzo family of rules, there are rules for the main Arazzo specifica
 The below rules are being migrated to Respect:
 
 - [no-criteria-xpath](./respect/no-criteria-xpath.md): the `xpath` type criteria is not supported by Respect.
-- [respect-supported-versions](./respect/respect-supported-versions.md): the `version` property must be one of the supported values.
+- [no-x-security-both-scheme-and-scheme-name](./respect/no-x-security-both-scheme-and-scheme-name.md): forbids using both `scheme` and `schemeName` in the same `x-security` item
 - [no-x-security-scheme-name-without-openapi](./respect/no-x-security-scheme-name-without-openapi.md): the `x-security` can't use `schemeName` when Step request is described with `x-operation`.
-- [x-security-scheme-required-values](./respect/x-security-scheme-required-values.md) validate that `x-security` have all required `values` described according to the used `scheme`.
+- [respect-supported-versions](./respect/respect-supported-versions.md): the `version` property must be one of the supported values.
 - [x-security-scheme-name-reference](./respect/x-security-scheme-name-reference.md): when multiple `sourceDescriptions` exist, `workflow.x-security.schemeName` must reference a source description (for example, `$sourceDescriptions.{name}.scheme`)
-- [no-x-security-both-scheme-and-scheme-name](./respect/no-x-security-both-scheme-and-scheme-name.md): forbids using both `scheme` and `schemeName` in the same `x-security` item
+- [x-security-scheme-required-values](./respect/x-security-scheme-required-values.md) validate that `x-security` have all required `values` described according to the used `scheme`.
 
 ## Resources
 

docs/@v2/rules/respect/x-security-scheme-name-reference.md

@@ -1,14 +1,14 @@
 # x-security-scheme-name-reference
 
-When multiple `sourceDescriptions` exist, `workflow.x-security.schemeName` must be a reference to a specific source description (for example, `$sourceDescriptions.{name}.scheme`). If there is only one source description, a plain string is allowed.
+When multiple `sourceDescriptions` exist, `workflow.x-security.schemeName` must be a reference to a specific source description (for example, `$sourceDescriptions.{name}.schemeName`). If there is only one source description, a plain string is allowed.
 
 | Arazzo | Compatibility |
 | ------ | ------------- |
 | 1.x    | ✅            |
 
 ## Design principles
 
-With multiple source descriptions, using a plain `schemeName` is ambiguous. Requiring a reference of the form `$sourceDescriptions.{name}.scheme` disambiguates which source description provides the security scheme.
+With multiple source descriptions, using a plain `schemeName` is ambiguous. Requiring a reference of the form `$sourceDescriptions.{name}.schemeName` disambiguates which source description provides the security scheme.
 
 ## Configuration
 

docs/@v2/sidebars.yaml

@@ -149,10 +149,10 @@
             - separator: Arazzo
             - page: rules/respect/no-criteria-xpath.md
             - page: rules/respect/respect-supported-versions.md
+            - page: rules/respect/no-x-security-both-scheme-and-scheme-name.md
             - page: rules/respect/no-x-security-scheme-name-without-openapi.md
-            - page: rules/respect/x-security-scheme-required-values.md
             - page: rules/respect/x-security-scheme-name-reference.md
-            - page: rules/respect/no-x-security-both-scheme-and-scheme-name.md
+            - page: rules/respect/x-security-scheme-required-values.md
             - page: rules/arazzo/criteria-unique.md
             - page: rules/arazzo/parameters-unique.md
             - page: rules/arazzo/requestBody-replacements-unique.md

packages/core/src/config/all.ts

@@ -276,24 +276,24 @@ const all: RawGovernanceConfig<'built-in'> = {
   arazzo1Rules: {
     'criteria-unique': 'error',
     'no-criteria-xpath': 'off',
+    'no-enum-type-mismatch': 'error',
+    'no-required-schema-properties-undefined': 'error',
+    'no-schema-type-mismatch': 'error',
+    'no-x-security-both-scheme-and-scheme-name': 'off',
+    'no-x-security-scheme-name-without-openapi': 'off',
     'parameters-unique': 'error',
     'requestBody-replacements-unique': 'error',
+    'respect-supported-versions': 'off',
+    'sourceDescription-name-unique': 'error',
     'sourceDescription-type': 'error',
-    'step-onSuccess-unique': 'error',
+    'sourceDescriptions-not-empty': 'error',
     'step-onFailure-unique': 'error',
+    'step-onSuccess-unique': 'error',
     'stepId-unique': 'error',
-    'sourceDescription-name-unique': 'error',
-    'sourceDescriptions-not-empty': 'error',
-    'respect-supported-versions': 'off',
-    'workflowId-unique': 'error',
     'workflow-dependsOn': 'error',
-    'no-x-security-scheme-name-without-openapi': 'off',
-    'x-security-scheme-required-values': 'off',
-    'no-required-schema-properties-undefined': 'error',
-    'no-enum-type-mismatch': 'error',
-    'no-schema-type-mismatch': 'error',
+    'workflowId-unique': 'error',
     'x-security-scheme-name-reference': 'off',
-    'no-x-security-both-scheme-and-scheme-name': 'off',
+    'x-security-scheme-required-values': 'off',
   },
   overlay1Rules: {
     'info-contact': 'error',

packages/core/src/config/minimal.ts

@@ -258,7 +258,7 @@ const minimal: RawGovernanceConfig<'built-in'> = {
     'no-enum-type-mismatch': 'warn',
     'no-required-schema-properties-undefined': 'warn',
     'no-schema-type-mismatch': 'warn',
-    'no-x-security-scheme-name-in-workflow': 'off',
+    'no-x-security-both-scheme-and-scheme-name': 'off',
     'no-x-security-scheme-name-without-openapi': 'off',
     'parameters-unique': 'off',
     'requestBody-replacements-unique': 'off',
@@ -271,6 +271,7 @@ const minimal: RawGovernanceConfig<'built-in'> = {
     'stepId-unique': 'error',
     'workflow-dependsOn': 'off',
     'workflowId-unique': 'error',
+    'x-security-scheme-name-reference': 'off',
     'x-security-scheme-required-values': 'off',
   },
   overlay1Rules: {

packages/core/src/config/recommended-strict.ts

@@ -258,7 +258,7 @@ const recommendedStrict: RawGovernanceConfig<'built-in'> = {
     'no-enum-type-mismatch': 'error',
     'no-required-schema-properties-undefined': 'error',
     'no-schema-type-mismatch': 'error',
-    'no-x-security-scheme-name-in-workflow': 'off',
+    'no-x-security-both-scheme-and-scheme-name': 'off',
     'no-x-security-scheme-name-without-openapi': 'off',
     'parameters-unique': 'error',
     'requestBody-replacements-unique': 'error',
@@ -271,6 +271,7 @@ const recommendedStrict: RawGovernanceConfig<'built-in'> = {
     'stepId-unique': 'error',
     'workflow-dependsOn': 'error',
     'workflowId-unique': 'error',
+    'x-security-scheme-name-reference': 'off',
     'x-security-scheme-required-values': 'off',
   },
   overlay1Rules: {

packages/core/src/config/recommended.ts

@@ -258,7 +258,7 @@ const recommended: RawGovernanceConfig<'built-in'> = {
     'no-enum-type-mismatch': 'error',
     'no-required-schema-properties-undefined': 'warn',
     'no-schema-type-mismatch': 'error',
-    'no-x-security-scheme-name-in-workflow': 'off',
+    'no-x-security-both-scheme-and-scheme-name': 'off',
     'no-x-security-scheme-name-without-openapi': 'off',
     'parameters-unique': 'error',
     'requestBody-replacements-unique': 'warn',
@@ -271,6 +271,7 @@ const recommended: RawGovernanceConfig<'built-in'> = {
     'stepId-unique': 'error',
     'workflow-dependsOn': 'error',
     'workflowId-unique': 'error',
+    'x-security-scheme-name-reference': 'off',
     'x-security-scheme-required-values': 'off',
   },
   overlay1Rules: {

packages/core/src/config/spec.ts

@@ -258,7 +258,7 @@ const spec: RawGovernanceConfig<'built-in'> = {
     'no-enum-type-mismatch': 'off',
     'no-required-schema-properties-undefined': 'off',
     'no-schema-type-mismatch': 'off',
-    'no-x-security-scheme-name-in-workflow': 'off',
+    'no-x-security-both-scheme-and-scheme-name': 'off',
     'no-x-security-scheme-name-without-openapi': 'off',
     'parameters-unique': 'error',
     'requestBody-replacements-unique': 'error',
@@ -271,6 +271,7 @@ const spec: RawGovernanceConfig<'built-in'> = {
     'stepId-unique': 'error',
     'workflow-dependsOn': 'error',
     'workflowId-unique': 'error',
+    'x-security-scheme-name-reference': 'off',
     'x-security-scheme-required-values': 'off',
   },
   overlay1Rules: {