docs: minor docs fixes

RomanHotsiy · RomanHotsiy · commit 4d94bf95eb8c · 2020-07-04T10:54:10.000+03:00
diff --git a/README.md b/README.md
@@ -115,35 +115,35 @@ Below is the `recommended` preset:
 
 ```yaml
   rules:
-    info-description: warning
+    info-description: warn
     info-contact: off
     info-license: off
     info-license-url: off
 
-    tag-description: warning
+    tag-description: warn
     tags-alphabetical: off
 
-    no-server-example.com: warning
+    no-server-example.com: warn
     no-server-trailing-slash: error
-    no-empty-servers: warning
+    no-empty-servers: warn
 
     parameter-description: off
     no-path-trailing-slash: error
     path-declaration-must-exist: error
     path-not-include-query: error
     path-parameters-defined: error
     operation-description: off
-    operation-2xx-response: warning
+    operation-2xx-response: warn
     operation-operationId-unique: error
     operation-parameters-unique: error
     operation-tag-defined: off
-    operation-security-defined: warning
+    operation-security-defined: warn
     operationId-valid-in-url: error
     operation-singular-tag: off
 
     no-example-value-and-externalValue: error
 
-    no-unused-components: warning
+    no-unused-components: warn
     no-unresolved-refs: error
     no-enum-type-mismatch: error
 
@@ -159,11 +159,11 @@ Here is an example of a modified use `.redocly.yaml` file:
 ```yaml
 lint:
   rules:
-    parameter-description: warning
+    parameter-description: warn
     operationId-valid-in-url: off
 ```
 
-Each rule can be turned `off`. In addition, you can control the log-level severity, between `warning` and `error`.
+Each rule can be turned `off`. In addition, you can control the log-level severity, between `warn` and `error`.
 
 Enabling a rule:
 ```yaml
@@ -201,7 +201,7 @@ lint:
 
 Possible values are:
 
-* warning
+* warn
 * error
 
 #### Ignore file
@@ -232,7 +232,8 @@ Ignore file can be autogenerated to add all messages to it by running `openapi l
 [Plugins](docs/plugins.md)
 [Type extensions](docs/type-extensions.md)
 [Custom rules](docs/custom-rules.md)
-[Transformers](docs/transformers.md)
+[Decorators](docs/decorators.md)
+[Preprocessors](docs/preprocessors.md)
 
 ## Credits
 
diff --git a/docs/TRANSFORMERS.md b/docs/TRANSFORMERS.md
diff --git a/docs/preprocessors.md b/docs/preprocessors.md
@@ -0,0 +1,13 @@
+# Preprocessors
+
+> NOTE: this feature is experimental. Modifying your data may break codeframes in errors.
+
+## Rationale
+
+There might appear such situation, when the input data should be mutated before applying default rules and/or bundling. For this case, you might want to run certain custom preprocessors before rules.
+
+You can do it with `preprocessors`.
+
+## Usage
+
+TBD
diff --git a/docs/rules.md b/docs/rules.md
@@ -5,7 +5,7 @@
 All supported rules are listed below. To change your settings for any given rule, just add or modify a corresponding item in the `rules` section of the `.redocly.yaml` in your working directory.
 
 Each of the `rules` entries can be one of following:
-- `rule-name`: `{severity}`, where `{severity}` is on of `error`, `warning` or `off`
+- `rule-name`: `{severity}`, where `{severity}` is on of `error`, `warn` or `off`
 - ```
   rule-name:
     severity: {severity}
diff --git a/resources/.redocly.yaml b/resources/.redocly.yaml
@@ -6,7 +6,7 @@ lint:
     - recommended
     - local/all
   rules:
-    operation-2xx-response: warning
+    operation-2xx-response: warn
     no-invalid-media-type-examples: error
     operation-description: off
     path-http-verbs-order: error
