updated documentation

Author: micheletriaca

docs/api.html

@@ -864,7 +864,7 @@ <h2> Supported vendor extensions</h2>
         <div class="table-block">
           <table class="m-table">
             <tr>
-              <td class="mono bold right" style="width:130px;" >x-code-sample <br/> x-codeSample </td>
+              <td class="mono bold right" style="width:140px;" >x-code-sample <br/> x-codeSample </td>
               <td class="gray"> Use this vendor-extension to provide code samples in various languages
               </td>
               <td style="width:130px;"><a href="./examples/code-samples.html"> Usage Example </a> </td>
@@ -884,9 +884,10 @@ <h2> Supported vendor extensions</h2>
             </tr>
 
             <tr>
-              <td class="mono bold right">x-client-id <br/> x-client-secret </td>
+              <td class="mono bold right">x-client-id <br/> x-client-secret <br/> x-default-scopes </td>
               <td class="gray">
-                Use these vendor-extensions to pre fill <span class="mono bold">client-id</span> and <span class="mono bold">client-secret</span> in the UI
+                Use these vendor-extensions to pre fill <span class="mono bold">client-id</span> and <span class="mono bold">client-secret</span>
+                and to eventually pre select <span class="mono bold">scopes</span> in the UI
               </td>
               <td><a href="./examples/oauth-vendor-extension.html"> Usage Example </a> </td>
             </tr>

docs/list.html

@@ -375,7 +375,8 @@ <h2 style="font-weight:700"> OAuth Setup </h2>
     <div class = "container">
       <a href="./examples/oauth-vendor-extension.html"> OAuth Extensions</a>
       <div class = "c-description" >
-        Pre fill client-id and client-secret with vendor extension 'x-client-id' and 'x-client-secret'
+        Pre fill client-id and client-secret with vendor extension 'x-client-id' and 'x-client-secret', and pre select
+        desired scopes with vendor extension 'x-default-scopes'
       </div>
     </div>
     <div class = "container">

docs/specs/oauth-vendor-extension.yaml

@@ -2,10 +2,11 @@ openapi: 3.0.0
 info:
   title: Petstore API
   description: |
-    Example to show how to use `x-client-id` and `x-client-secret` vendor extensions to pre fill them in the UI.
-    
-    Below is the Open API spec snippet that shows its usage, 
-    and if you check the authentication section you will find that client-id and client-secret is pre-filled, the user just needs to click on `GET TOKEN`
+    Example to show how to use `x-client-id`, `x-client-secret` and `x-default-scopes` vendor extensions to pre fill them in the UI.
+
+    Below is the Open API spec snippet that shows its usage,
+    and if you check the authentication section you will find that client-id and client-secret are pre-filled, the user just needs to click on `GET TOKEN`.
+    Also notice that the scope `dog-lover` is already checked
     ```yaml
       openapi: 3.0.0
       ...
@@ -16,15 +17,14 @@ info:
             type: oauth2
             x-client-id: my-client-id             # <--- when provided it will be pre filled in RapiDoc UI
             x-client-secret: my-client-secret     # <--- when provided it will be pre filled in RapiDoc UI
-            x-default-scopes: [dog-lover, another-one]     # <--- when provided scopes will be pre checked in RapiDoc UI
+            x-default-scopes: [dog-lover]         # <--- when provided scopes will be pre checked in RapiDoc UI
             flows:
               authorizationCode:
                 authorizationUrl: /authorize
                 tokenUrl: /access_token
                 scopes:
                   dog-lover: "always required"
                   owner: "optional"
-                  another-one: "optional"
     ```
   version: "1.0"
 security:
@@ -57,19 +57,16 @@ components:
       x-client-secret: my-client-secret
       x-default-scopes:
         - dog-lover
-        - another-one
       flows:
         authorizationCode:
           authorizationUrl: /authorize
           tokenUrl: /access_token
           scopes:
             dog-lover: "always required"
             owner: "optional"
-            another-one: "optional"
         clientCredentials:
           tokenUrl: '/token'
           scopes:
             dog-lover: "always required"
             owner: "optional"
-            another-one: "optional"