Sync develop

.nvmrc

@@ -1 +1 @@
-16.20
+20.19.5

package.json

@@ -7,7 +7,7 @@
     "url": "https://github.com/AdobeDocs/commerce-webapi"
   },
   "dependencies": {
-    "@adobe/gatsby-theme-aio": "4.15.3",
+    "@adobe/gatsby-theme-aio": "4.15.5",
     "gatsby": "4.22.0",
     "react": "^17.0.2",
     "react-dom": "^17.0.2"
@@ -18,7 +18,7 @@
     "remark-heading-id": "^1.0.1",
     "remark-lint-frontmatter-schema": "^3.15.4",
     "remark-validate-links": "^13.0.1",
-    "spectaql": "^3.0.2"
+    "spectaql": "^3.0.5"
   },
   "scripts": {
     "start": "NODE_OPTIONS='--max-old-space-size=8192' gatsby build && gatsby serve",

spectaql/comdox-theme/views/partials/layout/content/introduction/welcome.hbs

@@ -0,0 +1,65 @@
+<div id="welcome" class="doc-row">
+  <div class="doc-copy">
+    {{md info.description}}
+  </div>
+  <div class="doc-examples">
+    {{#if info.contact}}
+      <div class="example-section welcome-contact-section">
+        <h5>Contact</h5>
+        {{#if info.contact.name}}
+          <p class="contact-name">{{info.contact.name}}</p>
+        {{/if}}
+        {{#if info.contact.email}}
+          <p class="contact-email"><a href="mailto:{{info.contact.email}}">{{info.contact.email}}</a></p>
+        {{/if}}
+        {{#if info.contact.url}}
+          <p class="contact-url"><a href="{{info.contact.url}}">{{info.contact.url}}</a></p>
+        {{/if}}
+      </div>
+    {{/if}}
+
+    {{#if info.license}}
+      <div class="example-section welcome-license-section">
+        <h5>License</h5>
+        {{#if info.license.name}}
+          <p class="license-name">{{info.license.name}}</p>
+        {{/if}}
+        {{#if info.license.url}}
+          <p class="license-url"><a href="{{info.license.url}}">{{info.license.url}}</a></p>
+        {{/if}}
+      </div>
+    {{/if}}
+
+    {{#if info.termsOfService}}
+      <div class="example-section welcome-tos-section">
+        <h5>Terms of Service</h5>
+        <p><a href="{{info.termsOfService}}">{{info.termsOfService}}</a></p>
+      </div>
+    {{/if}}
+
+    {{#if (or url server servers)}}
+      <div class="example-section welcome-api-endpoints-section example-section-is-code">
+        <h5>API Endpoint</h5>
+        <pre><code>{{generateApiEndpoints}}</code></pre>
+      </div>
+    {{/if}}
+
+    {{#if (and servers servers.[0].headers)}}
+      <div class="example-section welcome-api-endpoints-section">
+        <h5>Headers</h5>
+        {{#each servers.[0].headers}}
+          {{#if comment}}
+            <div style="color: #222;">{{{comment}}}</div>
+          {{/if}}
+        {{/each}}
+      </div>
+    {{/if}}
+
+    {{#if info.version}}
+      <div class="example-section welcome-version-section">
+        <h5>Version</h5>
+        <p>{{info.version}}</p>
+      </div>
+    {{/if}}
+  </div>
+</div>

spectaql/config.yml

@@ -391,7 +391,7 @@ servers:
     headers:
       - name: Authorization
         example: Bearer <YOUR_TOKEN_HERE>
-        comment: Your API token from the dashboard. Must be included in all API calls.
+        comment: For header information, refer to <a href="https://developer.adobe.com/commerce/webapi/graphql/usage/headers">GraphQL headers</a>.
 
 info:
   # Tries to adhere to OpenAPI Specification https://swagger.io/specification/#info-object

spectaql/config_saas.yml

@@ -388,10 +388,10 @@ servers:
     # If no server entries are defined at all, the Introspection URL will be used.
     # production: true
     # A place to list any Headers for your GraphQL API calls
-    # headers:
-    #   - name: Authorization
-    #     example: Bearer <YOUR_TOKEN_HERE>
-    #     comment: Your API token from the dashboard. Must be included in all API calls.
+    headers:
+      - name: Authorization
+        example: Bearer <YOUR_TOKEN_HERE>
+        comment: For header information, refer to <a href="https://developer.adobe.com/commerce/webapi/graphql/usage/headers">GraphQL headers</a>.
 
 info:
   # Tries to adhere to OpenAPI Specification https://swagger.io/specification/#info-object