Fixes according to review https://github.com/regulaforensics/FaceSDK-web-openapi/pull/91/files

Author: irynaharoshka

common.yml

@@ -449,17 +449,7 @@ components:
 
     FaceSDKResultCode:
       type: integer
-      description: "The result code, see the [FaceSDKResultCode enum](https://docs.regulaforensics.com/develop/face-sdk/web-service/development/enums/face-sdk-result-code/).
-      
-      Some of the values: 
-      
-      - `0`—everything is OK
-
-      - `1`—image is empty, try again with another image
-
-      - `2`—face is not detected
-
-      - `6`—data cannot be decoded as an image"
+      description: "The result code, see the [FaceSDKResultCode enum](https://docs.regulaforensics.com/develop/face-sdk/web-service/development/enums/face-sdk-result-code/)."
       enum:
         - 0
         - 1

detect.yml

@@ -6,7 +6,6 @@ paths:
     post:
       tags:
         - matching
-      summary: "detect faces"
       description: "Detect face, evaluate attributes, assess the portrait quality"      
       operationId: detect
       requestBody:

index.yml

@@ -6,14 +6,14 @@ info:
     url: 'https://static-content.regulaforensics.com/Icons/Logos/Regula-logo.svg'
     href: 'https://mobile.regulaforensics.com/'
   description: |
-    <a href="https://regulaforensics.com/products/face-recognition-sdk/  " target="_blank">Regula Face SDK</a> is a cross-platform biometric verification solution for a digital identity verification process. The SDK enables convenient and reliable face capture on the client side (mobile, web, and desktop) and further processing on the client or server side.
+    <a href="https://regulaforensics.com/products/face-recognition-sdk/  " target="_blank">Regula Face SDK</a> is a cross-platform biometric verification solution for a digital identity verification process and image quality assurance. The SDK enables convenient and reliable face capture on the client side (mobile, web, and desktop) and further processing on the client or server side. 
 
     The Face SDK includes the following features:
     
-    * <a href="https://docs.regulaforensics.com/develop/face-sdk/overview/introduction/#face-detection" target="_blank">Face Detection</a>
-    * <a href="https://docs.regulaforensics.com/develop/face-sdk/overview/introduction/#face-comparison-11" target="_blank">Face Match (1:1)</a>
-    * <a href="https://docs.regulaforensics.com/develop/face-sdk/overview/introduction/#face-identification-1n" target="_blank">Face Search (1:N)</a>
-    * <a href="https://docs.regulaforensics.com/develop/face-sdk/overview/introduction/#liveness-assessment" target="_blank">Liveness Assessment</a>
+    * <a href="https://docs.regulaforensics.com/develop/face-sdk/overview/introduction/#face-detection" target="_blank">Face detection and image quality assessment</a>
+    * <a href="https://docs.regulaforensics.com/develop/face-sdk/overview/introduction/#face-comparison-11" target="_blank">Face match (1:1)</a>
+    * <a href="https://docs.regulaforensics.com/develop/face-sdk/overview/introduction/#face-identification-1n" target="_blank">Face search (1:N)</a>
+    * <a href="https://docs.regulaforensics.com/develop/face-sdk/overview/introduction/#liveness-assessment" target="_blank">Liveness detection</a>
 
     Here is the <a href="https://github.com/regulaforensics/FaceSDK-web-openapi  " target="_blank">OpenAPI specification on GitHub</a>. 
 

matching.yml

@@ -82,7 +82,7 @@ components:
                     type: integer
                 returnOriginalRect:
                   type: boolean
-                  description: "Whether to return the coordinates of the rectangle with the face in the original image prepared for the face crop. Can be used only if the face in the original image is not tilted."
+                  description: "Whether to return the coordinates of the rectangle with the face in the original image prepared for the face crop."
                   default: null
                 size:
                   type: array
@@ -92,7 +92,7 @@ components:
                     type: integer
                 type:
                   type: integer
-                  description: "The aspect ratio according to which face alignment is performed. See the [FaceImageQualityAlignType enum](https://docs.regulaforensics.com/develop/face-sdk/web-service/development/enums/face-image-quality-align-type/). To get a thumbnail with dimensions 3x4, set `0`."
+                  description: "The aspect ratio according to which face alignment is performed. See the [FaceImageQualityAlignType enum](https://docs.regulaforensics.com/develop/face-sdk/web-service/development/enums/face-image-quality-align-type/). To get a thumbnail with aspect ratio 3:4, set `0`."
                   default: null
                   enum:
                     - 0