feat: update documentation

Author: simply-alliv

src/jsdocs/admins.yaml

@@ -9,10 +9,6 @@ paths:
       summary: Register an administrator
 
       responses:
-        "200":
-          description: Successful operation
-          schema:
-            $ref: "#/definitions/CreateAdminResponse"
         "400":
           description: Invalid body supplied
           schema:

src/jsdocs/definitions.yaml

@@ -3,20 +3,9 @@ definitions:
   BadRequestResponse:
     type: object
     properties:
-      message:
+      status:
         type: string
-      success:
-        type: boolean
-        example: false
-      errors:
-        type: array
-        items:
-          type: object
-          properties:
-            title:
-              type: string
-            status:
-              type: integer
-              example: 400
-            detail:
-              type: string
+        example: error
+      error:
+        type: string
+        example: Invalid body supplied

src/jsdocs/providers.yaml

@@ -17,15 +17,15 @@ paths:
           schema:
             type: object
             properties:
-              message:
+              status:
                 type: string
-              success:
-                type: boolean
+                example: success
               data:
                 type: object
                 properties:
                   redirectUrl:
                     type: string
+                    example: https://accounts.google.com/o/oauth2/v2/auth/oauthchooseaccount
         "400":
           description: Invalid body supplied
           schema:

src/jsdocs/users.yaml

@@ -9,10 +9,6 @@ paths:
       summary: Register a user
 
       responses:
-        "200":
-          description: Successful operation
-          schema:
-            $ref: "#/definitions/RegisterUserResponse"
         "400":
           description: Invalid body supplied
           schema: