Better validate spec using openAPI output

Author: SamyPesse

docs/SUMMARY.md

@@ -0,0 +1,29 @@
+# Sumamry
+
+- [Welcome](README.md)
+- [Quickstart](quickstart.md)
+
+## Integrations
+
+- [Overview](integrations/README.md)
+- [Configurations](integrations/configurations.md)
+- [Runtime](integrations/runtime/README.md)
+  - [Runtime APIs](integrations/runtime/apis.md)
+  - Environment
+- [HTTP Fetch](integrations/fetch.md)
+
+## API
+
+- Overview
+- References
+  - Spaces
+    - Content
+    - Views
+    - Change Requests
+  - Users
+  - Organizations
+  - Integrations
+    - Installations
+- Clients
+  - Browser / Node
+

docs/integrations/README.md

@@ -0,0 +1,14 @@
+# Runtime API
+
+## `addEventListener()`
+
+## `fetch()`
+
+## `Response`
+
+## `Request`
+
+## `URL`
+
+## `URLSearchParam`
+

docs/integrations/runtime/README.md

@@ -1,9 +1,19 @@
 # Quickstart
 
-## Step 1: Install the GitBook CLI
+### Step 1: Install the GitBook CLI
 
 The GitBook Development CLI requires Node v18 or later. It can be installed from NPM using:
 
 ```
 npm install @gitbook/cli -g
 ```
+
+### Step 2: Authenticate with your account
+
+Create an API token in your GitBook.com at [app.gitbook.com/account/developer](https://app.gitbook.com/account/developer).
+
+Then run the following command to authenticate locally:
+
+```
+gitbook auth
+```

docs/integrations/runtime/apis.md

@@ -1,5 +1,6 @@
 name: slack
 title: Slack
+icon: ./icon.png
 description: Notify a channel or individual in Slack with real-time events from GitBook.
 script: ./script.ts
 scopes:
@@ -21,6 +22,11 @@ configurations:
         title: Channel
         description: Select a channel to post message to.
         completion_url: /conversations
+      notify_content_update:
+        type: boolean
+        title: Notify Content Update
+        description: Post a notification message every time the content of the space is updated.
+        default: true
     required:
       - oauth_credentials
       - conversation