From 223f40246415507eaeff19adbb764eece2c955a1 Mon Sep 17 00:00:00 2001
From: Diana <75819066+cloudjumpercat@users.noreply.github.com>
Date: Mon, 8 Jul 2024 16:09:55 -0500
Subject: [PATCH 1/8] Create placeholder Get Started section, create
 placeholder pages for new docs, move existing docs to the correct spot

Signed-off-by: Diana <75819066+cloudjumpercat@users.noreply.github.com>
---
 docs/_data/main-nav.yaml                      | 47 ++++++++++++++-----
 .../get-started/collections/create.md         |  8 ++++
 .../collections/pre-request-script.md         |  8 ++++
 .../collections}/send-your-first-request.md   |  1 +
 .../documents/generate-collection.md          |  8 ++++
 .../documents/pre-request-script.md           |  8 ++++
 docs/insomnia/get-started/documents/spec.md   |  8 ++++
 docs/insomnia/get-started/documents/test.md   |  8 ++++
 .../{get-started.md => get-started/index.md}  | 16 +++++++
 docs/insomnia/{ => get-started}/install.md    |  2 +
 .../mock-server/allowlist.md}                 |  8 ++--
 .../mock-server}/import-export-data.md        |  4 +-
 .../{ => get-started/mock-server}/proxy.md    |  4 +-
 13 files changed, 113 insertions(+), 17 deletions(-)
 create mode 100644 docs/insomnia/get-started/collections/create.md
 create mode 100644 docs/insomnia/get-started/collections/pre-request-script.md
 rename docs/insomnia/{ => get-started/collections}/send-your-first-request.md (91%)
 create mode 100644 docs/insomnia/get-started/documents/generate-collection.md
 create mode 100644 docs/insomnia/get-started/documents/pre-request-script.md
 create mode 100644 docs/insomnia/get-started/documents/spec.md
 create mode 100644 docs/insomnia/get-started/documents/test.md
 rename docs/insomnia/{get-started.md => get-started/index.md} (80%)
 rename docs/insomnia/{ => get-started}/install.md (98%)
 rename docs/insomnia/{enterprise-ip-whitelist-guide.md => get-started/mock-server/allowlist.md} (94%)
 rename docs/insomnia/{ => get-started/mock-server}/import-export-data.md (96%)
 rename docs/insomnia/{ => get-started/mock-server}/proxy.md (88%)

diff --git a/docs/_data/main-nav.yaml b/docs/_data/main-nav.yaml
index 888233b..29ab99d 100644
--- a/docs/_data/main-nav.yaml
+++ b/docs/_data/main-nav.yaml
@@ -1,19 +1,40 @@
 toc:
-  - title: Get Started, Design Debug and Test
+  - title: Get Started
     collapse-id: get-started
     items:
       - title: Introduction to Insomnia
         url: /insomnia/get-started
       - title: Install Insomnia
-        url: /insomnia/install
-      - title: Send Your First Request
-        url: /insomnia/send-your-first-request
-      - title: Import and Export Data
-        url: /insomnia/import-export-data
-      - title: Environment Variables
-        url: /insomnia/environment-variables
-      - title: Global Environments
-        url: /insomnia/global-environments
+        url: /insomnia/get-started/install
+      - title: Collections
+        collapse-id: collections
+        items:
+          - title: Create your first Collection
+            url: /insomnia/get-started/collections/create
+          - title: Send your first request
+            url: /insomnia/get-started/collections/send-your-first-request
+          - title: Add a pre-request script
+            url: /insomnia/get-started/collections/pre-request-script
+      - title: Documents
+        collapse-id: documents
+        items:
+          - title: Import an OpenAPI Spec
+            url: /insomnia/get-started/documents/spec
+          - title: Generate a Collection
+            url: /insomnia/get-started/documents/generate-collection
+          - title: Add a pre-request script
+            url: /insomnia/get-started/documents/pre-request-script
+          - title: Write your first test
+            url: /insomnia/get-started/documents/test
+      - title: Mock server
+        collapse-id: mock-server
+        items:
+          - title: Import data from another API client
+            url: /insomnia/get-started/mock-server/import-export-data
+          - title: Allowlist for Insomnia
+            url: /insomnia/get-started/mock-server/allowlist
+          - title: Configure a proxy server
+            url: /insomnia/get-started/mock-server/proxy
   - title: Insomnia Accounts
     collapse-id: insomnia-accounts
     items:
@@ -39,8 +60,6 @@ toc:
         url: /insomnia/enterprise-configure-okta-saml
       - title: Integrating Insomnia Enterprise with Microsoft Azure/Entra ID SAML 2.0
         url: /insomnia/enterprise-configure-azure-saml
-      - title: Insomnia Whitelisting Guide for Enterprise Users
-        url: /insomnia/enterprise-ip-whitelist-guide
       - title: Transfer enterprise organizations and license
         url: /insomnia/transfer-ownership-organization
   - title: Insomnia Subscription Plans
@@ -70,6 +89,10 @@ toc:
         url: /insomnia/chaining-requests
       - title: Post CSV Data
         url: /insomnia/post-csv-data
+      - title: Environment Variables
+        url: /insomnia/environment-variables
+      - title: Global Environments
+        url: /insomnia/global-environments
       - title: SOAP Requests
         url: /insomnia/soap-requests
       - title: gRPC
diff --git a/docs/insomnia/get-started/collections/create.md b/docs/insomnia/get-started/collections/create.md
new file mode 100644
index 0000000..01acea5
--- /dev/null
+++ b/docs/insomnia/get-started/collections/create.md
@@ -0,0 +1,8 @@
+---
+layout: article-detail
+title: Create your first Collection
+category: "Get Started"
+category-url: get-started
+---
+
+<!-- for rework: needs to include info about how to create collections, what they do, why you'd use them. Should also include a short, easy tutorial where users can try out collections, for example, see https://learning.postman.com/docs/getting-started/first-steps/creating-the-first-collection/ -->
\ No newline at end of file
diff --git a/docs/insomnia/get-started/collections/pre-request-script.md b/docs/insomnia/get-started/collections/pre-request-script.md
new file mode 100644
index 0000000..8f2d5d6
--- /dev/null
+++ b/docs/insomnia/get-started/collections/pre-request-script.md
@@ -0,0 +1,8 @@
+---
+layout: article-detail
+title: Add a pre-request script
+category: "Get Started"
+category-url: get-started
+---
+
+<!-- for rework: needs to include info about pre-request scripts for **collections**, what they do, why you'd use them. Should also include a short, easy tutorial where users can try out their first pre-request script, for example, see https://learning.postman.com/docs/tests-and-scripts/write-scripts/pre-request-scripts/#scripting-before-your-request-runs   (it should be a simple example, we can explain more examples and use cases and features in a different topic)-->
\ No newline at end of file
diff --git a/docs/insomnia/send-your-first-request.md b/docs/insomnia/get-started/collections/send-your-first-request.md
similarity index 91%
rename from docs/insomnia/send-your-first-request.md
rename to docs/insomnia/get-started/collections/send-your-first-request.md
index 24512f6..f36efd1 100644
--- a/docs/insomnia/send-your-first-request.md
+++ b/docs/insomnia/get-started/collections/send-your-first-request.md
@@ -4,6 +4,7 @@ title:  Send Your First Request
 category: "Get Started"
 category-url: get-started
 ---
+<!-- for rework: needs to include info about requests, what they do, why you'd use them. Should also include a short, easy tutorial where users can try out their first request, for example, see https://learning.postman.com/docs/getting-started/first-steps/sending-the-first-request/ -->
 
 Insomnia is an API client that enables you to send API requests outside of your terminal, and without writing any code. This means you don't have to write any finicky cURL requests or backend code to quickly retrieve information, push content to a database, and do anything else a given API enables you to do.
 
diff --git a/docs/insomnia/get-started/documents/generate-collection.md b/docs/insomnia/get-started/documents/generate-collection.md
new file mode 100644
index 0000000..4e9d9e5
--- /dev/null
+++ b/docs/insomnia/get-started/documents/generate-collection.md
@@ -0,0 +1,8 @@
+---
+layout: article-detail
+title: Generate a Collection
+category: "Get Started"
+category-url: get-started
+---
+
+<!-- for docs rework: Page should be very basic - how to generate a collection and set the required environment variables. You can sort of mimic the style of https://learning.postman.com/docs/getting-started/first-steps/creating-the-first-collection/, but for generating a collection instead of creating one -->
\ No newline at end of file
diff --git a/docs/insomnia/get-started/documents/pre-request-script.md b/docs/insomnia/get-started/documents/pre-request-script.md
new file mode 100644
index 0000000..b9b997b
--- /dev/null
+++ b/docs/insomnia/get-started/documents/pre-request-script.md
@@ -0,0 +1,8 @@
+---
+layout: article-detail
+title: Add a pre-request script
+category: "Get Started"
+category-url: get-started
+---
+
+<!-- for rework: needs to include info about pre-request scripts for **documents**, what they do, why you'd use them. Should also include a short, easy tutorial where users can try out their first pre-request script, for example, see https://learning.postman.com/docs/tests-and-scripts/write-scripts/pre-request-scripts/#scripting-before-your-request-runs   (it should be a simple example, we can explain more examples and use cases and features in a different topic)-->
\ No newline at end of file
diff --git a/docs/insomnia/get-started/documents/spec.md b/docs/insomnia/get-started/documents/spec.md
new file mode 100644
index 0000000..609f734
--- /dev/null
+++ b/docs/insomnia/get-started/documents/spec.md
@@ -0,0 +1,8 @@
+---
+layout: article-detail
+title: Import an OpenAPI Spec
+category: "Get Started"
+category-url: get-started
+---
+
+<!-- for rework: this page should contain a very easy, short example of how to import a spec into Insomnia. We should also provide some information in the introduction paragraph about what a spec is and why you'd want to use one or need one. You can use this doc as an example: https://learning.postman.com/docs/integrations/available-integrations/working-with-openAPI -->
\ No newline at end of file
diff --git a/docs/insomnia/get-started/documents/test.md b/docs/insomnia/get-started/documents/test.md
new file mode 100644
index 0000000..62c4448
--- /dev/null
+++ b/docs/insomnia/get-started/documents/test.md
@@ -0,0 +1,8 @@
+---
+layout: article-detail
+title: Write your first test
+category: "Get Started"
+category-url: get-started
+---
+
+<!-- for docs rework: should contain information about tests, why you'd want them, what they do, etc. You can use https://learning.postman.com/docs/getting-started/first-steps/write-your-first-test/ for an example of a short, easy tutorial -->
\ No newline at end of file
diff --git a/docs/insomnia/get-started.md b/docs/insomnia/get-started/index.md
similarity index 80%
rename from docs/insomnia/get-started.md
rename to docs/insomnia/get-started/index.md
index f91e725..74048cc 100644
--- a/docs/insomnia/get-started.md
+++ b/docs/insomnia/get-started/index.md
@@ -5,6 +5,22 @@ category: "Get Started"
 category-url: get-started
 ---
 
+<!--For rework: This page should contain info about Insomnia for those new to it. Tour of the UI and what things are called like Postman's (https://learning.postman.com/docs/getting-started/basics/navigating-postman/). Add a table of features with links to the docs about them (similar to https://docs.konghq.com/gateway/3.7.x/#features).
+
+
+Proposed outline:
+
+## Introduction to Insomnia
+
+## Navigating Insomnia
+
+add UI screenshot here with boxes around items and a table that references the box numbers and explains what the part of the UI is called and what it does
+
+## Features
+
+| Feature | Free | Enterprise |
+| Name of first feature | No | Yes |  -->
+
 Insomnia is an open source desktop application that takes the pain out of interacting with and designing, debugging, and testing APIs. Insomnia combines an easy-to-use interface with advanced functionality like authentication helpers, code generation, and environment variables.
 
 ![Insomnia client example screenshot](/assets/images/entry-page.png)
diff --git a/docs/insomnia/install.md b/docs/insomnia/get-started/install.md
similarity index 98%
rename from docs/insomnia/install.md
rename to docs/insomnia/get-started/install.md
index e1a1169..7178d66 100644
--- a/docs/insomnia/install.md
+++ b/docs/insomnia/get-started/install.md
@@ -5,6 +5,8 @@ category: "Get Started"
 category-url: get-started
 ---
 
+<!-- for rework: revise this page like we normally would -->
+
 Insomnia is available on macOS, Windows, and Linux. If you haven't already downloaded Insomnia, visit the [Download Page](https://insomnia.rest/download).
 
 <nav>
diff --git a/docs/insomnia/enterprise-ip-whitelist-guide.md b/docs/insomnia/get-started/mock-server/allowlist.md
similarity index 94%
rename from docs/insomnia/enterprise-ip-whitelist-guide.md
rename to docs/insomnia/get-started/mock-server/allowlist.md
index 5fcde38..4ab20e6 100644
--- a/docs/insomnia/enterprise-ip-whitelist-guide.md
+++ b/docs/insomnia/get-started/mock-server/allowlist.md
@@ -1,10 +1,12 @@
 ---
 layout: article-detail
-title:  Insomnia Whitelisting Guide for Enterprise Users
-category: "Insomnia Whitelisting Guide for Enterprise Users"
-category-url: enterprise-ip-whitelist-guide
+title:  Allowlist for Insomnia
+category: "Get Started"
+category-url: get-started
 ---
 
+<!-- for docs rework: revise this page like we normally would -->
+
 ## Introduction
 
 For enterprise users utilizing Insomnia, it's crucial to ensure that specific domains are whitelisted in your network. This step is essential to guarantee that all features of Insomnia, including updates, synchronization, and documentation, work without any hindrance in environments with restricted internet access.
diff --git a/docs/insomnia/import-export-data.md b/docs/insomnia/get-started/mock-server/import-export-data.md
similarity index 96%
rename from docs/insomnia/import-export-data.md
rename to docs/insomnia/get-started/mock-server/import-export-data.md
index 23e007b..4fb1a03 100644
--- a/docs/insomnia/import-export-data.md
+++ b/docs/insomnia/get-started/mock-server/import-export-data.md
@@ -1,10 +1,12 @@
 ---
 layout: article-detail
-title:  Import and Export Data
+title:  Import data from another API client
 category: "Get Started"
 category-url: get-started
 ---
 
+<!-- for docs rework: revise this page like we normally would -->
+
 Insomnia supports importing and exporting. Currently, the supported import formats are Insomnia, Postman v2, HAR, OpenAPI (versions 3.0, 3.1), Swagger, WSDL, and cURL.
 
 ## Export Data
diff --git a/docs/insomnia/proxy.md b/docs/insomnia/get-started/mock-server/proxy.md
similarity index 88%
rename from docs/insomnia/proxy.md
rename to docs/insomnia/get-started/mock-server/proxy.md
index 440011e..4e43693 100644
--- a/docs/insomnia/proxy.md
+++ b/docs/insomnia/get-started/mock-server/proxy.md
@@ -1,10 +1,12 @@
 ---
 layout: article-detail
-title:  Proxy
+title:  Configure a proxy server
 category: "Get Started"
 category-url: get-started
 ---
 
+<!-- for docs rework: revise this in the style of https://learning.postman.com/docs/getting-started/installation/proxy -->
+
 Insomnia does not automatically detect system-wide proxy settings. A proxy can be set up manually. Set your HTTP, HTTPS, SOCKS4 or SOCKS5 proxy server and reroute all future requests through that server by accessing Preferences via the cog icon > **General** > **HTTP Network Proxy**.
 
 {:.alert .alert-primary}

From 62bee930e9094fcdae55ea513ccf75cc117a6100 Mon Sep 17 00:00:00 2001
From: Diana <75819066+cloudjumpercat@users.noreply.github.com>
Date: Wed, 10 Jul 2024 11:55:15 -0500
Subject: [PATCH 2/8] Add redirects, make Collections Documents and Mock server
 subfolders in nav, remove frontmatter that isn't used from get Started pages

Signed-off-by: Diana <75819066+cloudjumpercat@users.noreply.github.com>
---
 docs/_data/main-nav.yaml                               | 10 ++++------
 docs/insomnia/get-started/collections/create.md        |  2 --
 .../get-started/collections/pre-request-script.md      |  2 --
 .../get-started/collections/send-your-first-request.md |  2 --
 .../get-started/documents/generate-collection.md       |  2 --
 .../get-started/documents/pre-request-script.md        |  2 --
 docs/insomnia/get-started/documents/spec.md            |  2 --
 docs/insomnia/get-started/documents/test.md            |  2 --
 docs/insomnia/get-started/index.md                     |  2 --
 docs/insomnia/get-started/install.md                   |  2 --
 docs/insomnia/get-started/mock-server/allowlist.md     |  2 --
 .../get-started/mock-server/import-export-data.md      |  2 --
 docs/insomnia/get-started/mock-server/proxy.md         |  2 --
 docs/vercel.json                                       |  8 +++++++-
 14 files changed, 11 insertions(+), 31 deletions(-)

diff --git a/docs/_data/main-nav.yaml b/docs/_data/main-nav.yaml
index 29ab99d..fdc55bd 100644
--- a/docs/_data/main-nav.yaml
+++ b/docs/_data/main-nav.yaml
@@ -7,8 +7,8 @@ toc:
       - title: Install Insomnia
         url: /insomnia/get-started/install
       - title: Collections
-        collapse-id: collections
-        items:
+        url: /insomnia/get-started/collections
+        subfolderitems:
           - title: Create your first Collection
             url: /insomnia/get-started/collections/create
           - title: Send your first request
@@ -16,8 +16,7 @@ toc:
           - title: Add a pre-request script
             url: /insomnia/get-started/collections/pre-request-script
       - title: Documents
-        collapse-id: documents
-        items:
+        subfolderitems:
           - title: Import an OpenAPI Spec
             url: /insomnia/get-started/documents/spec
           - title: Generate a Collection
@@ -27,8 +26,7 @@ toc:
           - title: Write your first test
             url: /insomnia/get-started/documents/test
       - title: Mock server
-        collapse-id: mock-server
-        items:
+        subfolderitems:
           - title: Import data from another API client
             url: /insomnia/get-started/mock-server/import-export-data
           - title: Allowlist for Insomnia
diff --git a/docs/insomnia/get-started/collections/create.md b/docs/insomnia/get-started/collections/create.md
index 01acea5..8262d8b 100644
--- a/docs/insomnia/get-started/collections/create.md
+++ b/docs/insomnia/get-started/collections/create.md
@@ -1,8 +1,6 @@
 ---
 layout: article-detail
 title: Create your first Collection
-category: "Get Started"
-category-url: get-started
 ---
 
 <!-- for rework: needs to include info about how to create collections, what they do, why you'd use them. Should also include a short, easy tutorial where users can try out collections, for example, see https://learning.postman.com/docs/getting-started/first-steps/creating-the-first-collection/ -->
\ No newline at end of file
diff --git a/docs/insomnia/get-started/collections/pre-request-script.md b/docs/insomnia/get-started/collections/pre-request-script.md
index 8f2d5d6..af85ccb 100644
--- a/docs/insomnia/get-started/collections/pre-request-script.md
+++ b/docs/insomnia/get-started/collections/pre-request-script.md
@@ -1,8 +1,6 @@
 ---
 layout: article-detail
 title: Add a pre-request script
-category: "Get Started"
-category-url: get-started
 ---
 
 <!-- for rework: needs to include info about pre-request scripts for **collections**, what they do, why you'd use them. Should also include a short, easy tutorial where users can try out their first pre-request script, for example, see https://learning.postman.com/docs/tests-and-scripts/write-scripts/pre-request-scripts/#scripting-before-your-request-runs   (it should be a simple example, we can explain more examples and use cases and features in a different topic)-->
\ No newline at end of file
diff --git a/docs/insomnia/get-started/collections/send-your-first-request.md b/docs/insomnia/get-started/collections/send-your-first-request.md
index f36efd1..e31c0cd 100644
--- a/docs/insomnia/get-started/collections/send-your-first-request.md
+++ b/docs/insomnia/get-started/collections/send-your-first-request.md
@@ -1,8 +1,6 @@
 ---
 layout: article-detail
 title:  Send Your First Request
-category: "Get Started"
-category-url: get-started
 ---
 <!-- for rework: needs to include info about requests, what they do, why you'd use them. Should also include a short, easy tutorial where users can try out their first request, for example, see https://learning.postman.com/docs/getting-started/first-steps/sending-the-first-request/ -->
 
diff --git a/docs/insomnia/get-started/documents/generate-collection.md b/docs/insomnia/get-started/documents/generate-collection.md
index 4e9d9e5..36a8679 100644
--- a/docs/insomnia/get-started/documents/generate-collection.md
+++ b/docs/insomnia/get-started/documents/generate-collection.md
@@ -1,8 +1,6 @@
 ---
 layout: article-detail
 title: Generate a Collection
-category: "Get Started"
-category-url: get-started
 ---
 
 <!-- for docs rework: Page should be very basic - how to generate a collection and set the required environment variables. You can sort of mimic the style of https://learning.postman.com/docs/getting-started/first-steps/creating-the-first-collection/, but for generating a collection instead of creating one -->
\ No newline at end of file
diff --git a/docs/insomnia/get-started/documents/pre-request-script.md b/docs/insomnia/get-started/documents/pre-request-script.md
index b9b997b..5f2c28a 100644
--- a/docs/insomnia/get-started/documents/pre-request-script.md
+++ b/docs/insomnia/get-started/documents/pre-request-script.md
@@ -1,8 +1,6 @@
 ---
 layout: article-detail
 title: Add a pre-request script
-category: "Get Started"
-category-url: get-started
 ---
 
 <!-- for rework: needs to include info about pre-request scripts for **documents**, what they do, why you'd use them. Should also include a short, easy tutorial where users can try out their first pre-request script, for example, see https://learning.postman.com/docs/tests-and-scripts/write-scripts/pre-request-scripts/#scripting-before-your-request-runs   (it should be a simple example, we can explain more examples and use cases and features in a different topic)-->
\ No newline at end of file
diff --git a/docs/insomnia/get-started/documents/spec.md b/docs/insomnia/get-started/documents/spec.md
index 609f734..544f2bf 100644
--- a/docs/insomnia/get-started/documents/spec.md
+++ b/docs/insomnia/get-started/documents/spec.md
@@ -1,8 +1,6 @@
 ---
 layout: article-detail
 title: Import an OpenAPI Spec
-category: "Get Started"
-category-url: get-started
 ---
 
 <!-- for rework: this page should contain a very easy, short example of how to import a spec into Insomnia. We should also provide some information in the introduction paragraph about what a spec is and why you'd want to use one or need one. You can use this doc as an example: https://learning.postman.com/docs/integrations/available-integrations/working-with-openAPI -->
\ No newline at end of file
diff --git a/docs/insomnia/get-started/documents/test.md b/docs/insomnia/get-started/documents/test.md
index 62c4448..f24f310 100644
--- a/docs/insomnia/get-started/documents/test.md
+++ b/docs/insomnia/get-started/documents/test.md
@@ -1,8 +1,6 @@
 ---
 layout: article-detail
 title: Write your first test
-category: "Get Started"
-category-url: get-started
 ---
 
 <!-- for docs rework: should contain information about tests, why you'd want them, what they do, etc. You can use https://learning.postman.com/docs/getting-started/first-steps/write-your-first-test/ for an example of a short, easy tutorial -->
\ No newline at end of file
diff --git a/docs/insomnia/get-started/index.md b/docs/insomnia/get-started/index.md
index 74048cc..62269a2 100644
--- a/docs/insomnia/get-started/index.md
+++ b/docs/insomnia/get-started/index.md
@@ -1,8 +1,6 @@
 ---
 layout: article-detail
 title:  Introduction to Insomnia
-category: "Get Started"
-category-url: get-started
 ---
 
 <!--For rework: This page should contain info about Insomnia for those new to it. Tour of the UI and what things are called like Postman's (https://learning.postman.com/docs/getting-started/basics/navigating-postman/). Add a table of features with links to the docs about them (similar to https://docs.konghq.com/gateway/3.7.x/#features).
diff --git a/docs/insomnia/get-started/install.md b/docs/insomnia/get-started/install.md
index 7178d66..d89ba22 100644
--- a/docs/insomnia/get-started/install.md
+++ b/docs/insomnia/get-started/install.md
@@ -1,8 +1,6 @@
 ---
 layout: article-detail
 title:  Install Insomnia
-category: "Get Started"
-category-url: get-started
 ---
 
 <!-- for rework: revise this page like we normally would -->
diff --git a/docs/insomnia/get-started/mock-server/allowlist.md b/docs/insomnia/get-started/mock-server/allowlist.md
index 4ab20e6..a9f38ca 100644
--- a/docs/insomnia/get-started/mock-server/allowlist.md
+++ b/docs/insomnia/get-started/mock-server/allowlist.md
@@ -1,8 +1,6 @@
 ---
 layout: article-detail
 title:  Allowlist for Insomnia
-category: "Get Started"
-category-url: get-started
 ---
 
 <!-- for docs rework: revise this page like we normally would -->
diff --git a/docs/insomnia/get-started/mock-server/import-export-data.md b/docs/insomnia/get-started/mock-server/import-export-data.md
index 4fb1a03..05051b0 100644
--- a/docs/insomnia/get-started/mock-server/import-export-data.md
+++ b/docs/insomnia/get-started/mock-server/import-export-data.md
@@ -1,8 +1,6 @@
 ---
 layout: article-detail
 title:  Import data from another API client
-category: "Get Started"
-category-url: get-started
 ---
 
 <!-- for docs rework: revise this page like we normally would -->
diff --git a/docs/insomnia/get-started/mock-server/proxy.md b/docs/insomnia/get-started/mock-server/proxy.md
index 4e43693..4c520f6 100644
--- a/docs/insomnia/get-started/mock-server/proxy.md
+++ b/docs/insomnia/get-started/mock-server/proxy.md
@@ -1,8 +1,6 @@
 ---
 layout: article-detail
 title:  Configure a proxy server
-category: "Get Started"
-category-url: get-started
 ---
 
 <!-- for docs rework: revise this in the style of https://learning.postman.com/docs/getting-started/installation/proxy -->
diff --git a/docs/vercel.json b/docs/vercel.json
index 6c0e3b2..f76f0f8 100644
--- a/docs/vercel.json
+++ b/docs/vercel.json
@@ -123,6 +123,12 @@
     { "source": "/category/(.*)", "destination": "/", "permanent": false },
     { "source": "/collection/(.*)", "destination": "/", "permanent": false },
 
-    { "source": "/insomnia/team-collaboration", "destination": "/insomnia/teams", "permanent": false}
+    { "source": "/insomnia/team-collaboration", "destination": "/insomnia/teams", "permanent": false},
+
+    { "source": "/insomnia/install", "destination": "/insomnia/get-started/install", "permanent": false},
+    { "source": "/insomnia/send-your-first-request", "destination": "/insomnia/get-started/collections/send-your-first-request", "permanent": false},
+    { "source": "/insomnia/import-export-data", "destination": "/insomnia/get-started/mock-server/import-export-data", "permanent": false},
+    { "source": "/insomnia/enterprise-ip-whitelist-guide", "destination": "/insomnia/get-started/mock-server/allowlist", "permanent": false},
+    { "source": "/insomnia/proxy", "destination": "/insomnia/get-started/mock-server/proxy", "permanent": false}
   ]
 }

From 68214ba5027b4536dbd6e3998b93b39aa0c5fd13 Mon Sep 17 00:00:00 2001
From: Diana <75819066+cloudjumpercat@users.noreply.github.com>
Date: Wed, 10 Jul 2024 11:58:52 -0500
Subject: [PATCH 3/8] Remove fake URL for Collections that was added on
 accident

Signed-off-by: Diana <75819066+cloudjumpercat@users.noreply.github.com>
---
 docs/_data/main-nav.yaml | 1 -
 1 file changed, 1 deletion(-)

diff --git a/docs/_data/main-nav.yaml b/docs/_data/main-nav.yaml
index fdc55bd..91dc2bf 100644
--- a/docs/_data/main-nav.yaml
+++ b/docs/_data/main-nav.yaml
@@ -7,7 +7,6 @@ toc:
       - title: Install Insomnia
         url: /insomnia/get-started/install
       - title: Collections
-        url: /insomnia/get-started/collections
         subfolderitems:
           - title: Create your first Collection
             url: /insomnia/get-started/collections/create

From 31abf09d88b599223d190ea84a99ece59ce42ea6 Mon Sep 17 00:00:00 2001
From: Fabian Rodriguez <fabian.rodriguez@konghq.com>
Date: Thu, 11 Jul 2024 08:45:04 +0200
Subject: [PATCH 4/8] Bump gems

---
 docs/Gemfile.lock | 62 +++++++++++++++++++++++++++--------------------
 1 file changed, 36 insertions(+), 26 deletions(-)

diff --git a/docs/Gemfile.lock b/docs/Gemfile.lock
index 38e2c24..12c70b3 100644
--- a/docs/Gemfile.lock
+++ b/docs/Gemfile.lock
@@ -1,38 +1,43 @@
 GEM
   remote: https://rubygems.org/
   specs:
-    addressable (2.8.0)
-      public_suffix (>= 2.0.2, < 5.0)
+    addressable (2.8.7)
+      public_suffix (>= 2.0.2, < 7.0)
+    bigdecimal (3.1.8)
     colorator (1.1.0)
-    concurrent-ruby (1.1.10)
+    concurrent-ruby (1.3.3)
     em-websocket (0.5.3)
       eventmachine (>= 0.12.9)
       http_parser.rb (~> 0)
     eventmachine (1.2.7)
-    ffi (1.15.5)
+    ffi (1.17.0-arm64-darwin)
     forwardable-extended (2.6.0)
+    google-protobuf (4.27.2-arm64-darwin)
+      bigdecimal
+      rake (>= 13)
     http_parser.rb (0.8.0)
-    i18n (1.10.0)
+    i18n (1.14.5)
       concurrent-ruby (~> 1.0)
-    jekyll (4.2.2)
+    jekyll (4.3.3)
       addressable (~> 2.4)
       colorator (~> 1.0)
       em-websocket (~> 0.5)
       i18n (~> 1.0)
-      jekyll-sass-converter (~> 2.0)
+      jekyll-sass-converter (>= 2.0, < 4.0)
       jekyll-watch (~> 2.0)
-      kramdown (~> 2.3)
+      kramdown (~> 2.3, >= 2.3.1)
       kramdown-parser-gfm (~> 1.0)
       liquid (~> 4.0)
-      mercenary (~> 0.4.0)
+      mercenary (>= 0.3.6, < 0.5)
       pathutil (~> 0.9)
-      rouge (~> 3.0)
+      rouge (>= 3.0, < 5.0)
       safe_yaml (~> 1.0)
-      terminal-table (~> 2.0)
+      terminal-table (>= 1.8, < 4.0)
+      webrick (~> 1.7)
     jekyll-feed (0.16.0)
       jekyll (>= 3.7, < 5.0)
-    jekyll-sass-converter (2.2.0)
-      sassc (> 2.0.1, < 3.0)
+    jekyll-sass-converter (3.0.0)
+      sass-embedded (~> 1.54)
     jekyll-seo-tag (2.8.0)
       jekyll (>= 3.8, < 5.0)
     jekyll-watch (2.2.1)
@@ -41,8 +46,8 @@ GEM
       rexml
     kramdown-parser-gfm (1.1.0)
       kramdown (~> 2.0)
-    liquid (4.0.3)
-    listen (3.7.1)
+    liquid (4.0.4)
+    listen (3.9.0)
       rb-fsevent (~> 0.10, >= 0.10.3)
       rb-inotify (~> 0.9, >= 0.9.10)
     mercenary (0.4.0)
@@ -52,25 +57,30 @@ GEM
       jekyll-seo-tag (~> 2.1)
     pathutil (0.16.2)
       forwardable-extended (~> 2.6)
-    public_suffix (4.0.7)
-    rb-fsevent (0.11.1)
-    rb-inotify (0.10.1)
+    public_suffix (6.0.0)
+    rake (13.2.1)
+    rb-fsevent (0.11.2)
+    rb-inotify (0.11.1)
       ffi (~> 1.0)
-    rexml (3.2.5)
-    rouge (3.28.0)
+    rexml (3.3.1)
+      strscan
+    rouge (4.3.0)
     safe_yaml (1.0.5)
-    sassc (2.4.0)
-      ffi (~> 1.9)
-    terminal-table (2.0.0)
-      unicode-display_width (~> 1.1, >= 1.1.1)
-    unicode-display_width (1.8.0)
+    sass-embedded (1.77.5-arm64-darwin)
+      google-protobuf (>= 3.25, < 5.0)
+    strscan (3.1.0)
+    terminal-table (3.0.2)
+      unicode-display_width (>= 1.1.1, < 3)
+    unicode-display_width (2.5.0)
+    webrick (1.8.1)
 
 PLATFORMS
+  arm64-darwin-23
   universal-darwin-20
   universal-darwin-21
 
 DEPENDENCIES
-  jekyll (~> 4.2.0)
+  jekyll (~> 4.3.0)
   jekyll-feed (~> 0.12)
   minima (~> 2.5)
   tzinfo (~> 1.2)

From 7f363ccfac76134ed6bc9f92bf9b8e1602f67d3e Mon Sep 17 00:00:00 2001
From: Fabian Rodriguez <fabian.rodriguez@konghq.com>
Date: Thu, 11 Jul 2024 08:45:21 +0200
Subject: [PATCH 5/8] Add collapse-id attribute to new sections

---
 docs/_data/main-nav.yaml | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/docs/_data/main-nav.yaml b/docs/_data/main-nav.yaml
index 91dc2bf..1046028 100644
--- a/docs/_data/main-nav.yaml
+++ b/docs/_data/main-nav.yaml
@@ -7,6 +7,7 @@ toc:
       - title: Install Insomnia
         url: /insomnia/get-started/install
       - title: Collections
+        collapse-id: collections
         subfolderitems:
           - title: Create your first Collection
             url: /insomnia/get-started/collections/create
@@ -15,6 +16,7 @@ toc:
           - title: Add a pre-request script
             url: /insomnia/get-started/collections/pre-request-script
       - title: Documents
+        collapse-id: documents
         subfolderitems:
           - title: Import an OpenAPI Spec
             url: /insomnia/get-started/documents/spec
@@ -25,6 +27,7 @@ toc:
           - title: Write your first test
             url: /insomnia/get-started/documents/test
       - title: Mock server
+        collapse-id: mock-server
         subfolderitems:
           - title: Import data from another API client
             url: /insomnia/get-started/mock-server/import-export-data

From 449f1b8f6fc2680ce4004d42aa5d122011ddf5f2 Mon Sep 17 00:00:00 2001
From: Fabian Rodriguez <fabian.rodriguez@konghq.com>
Date: Thu, 11 Jul 2024 08:45:46 +0200
Subject: [PATCH 6/8] Make nested sections expand/collapse

---
 docs/_includes/sidebar-nav.html | 19 +++++++++++++++----
 1 file changed, 15 insertions(+), 4 deletions(-)

diff --git a/docs/_includes/sidebar-nav.html b/docs/_includes/sidebar-nav.html
index a424653..427968b 100644
--- a/docs/_includes/sidebar-nav.html
+++ b/docs/_includes/sidebar-nav.html
@@ -12,11 +12,22 @@
           {% for entry in item.items %}
             {% assign currentEntry = entry.url | append: '/' %}
             <li class="doc-link ps-3 pb-1 text-start {% if currentEntry == page.url %} list-active {% endif %}">
-              <a href="{{ entry.url }}">
-                {{ entry.title }}
-              </a>
+              {% if entry.url %}
+                <a href="{{ entry.url }}">
+                  {{ entry.title }}
+                </a>
+              {% endif %}
               {% if entry.subfolderitems.size > 0 %}
-              <div class="collapse {% for subentry in entry.subfolderitems %}{% if page.url contains entry.url %} show {% break %}{% endif %}{% endfor %}">
+                {% if entry.collapse-id %}
+                <button class="border-0 align-items-center text-start ps-0 bg-white" data-bs-toggle="collapse" data-bs-target="#{{ entry.collapse-id }}-collapse" aria-expanded="true">
+                  <span>
+                    {{ entry.title }}
+                  </span>
+                </button>
+                {% endif %}
+
+              {% assign show = entry.subfolderitems | find_exp: 'sub_entry', 'page.url contains sub_entry.url' %}
+              <div class="collapse {% if show %} show {% endif %}" {% if entry.collapse-id %} id="{{ entry.collapse-id }}-collapse" {% endif %}>
                 <ul class="list-unstyled">
                   {% for subentry in entry.subfolderitems %}
                     {% assign currentSubEntry = subentry.url | append: '/' %}

From 183c153470174c26ceac5528108b764b72b0e56c Mon Sep 17 00:00:00 2001
From: Diana <75819066+cloudjumpercat@users.noreply.github.com>
Date: Mon, 15 Jul 2024 08:47:37 -0500
Subject: [PATCH 7/8] Revise and reformat some of the content (#226)

Signed-off-by: Diana <75819066+cloudjumpercat@users.noreply.github.com>
---
 docs/insomnia/get-started/install.md | 50 +++++++++++-----------------
 1 file changed, 19 insertions(+), 31 deletions(-)

diff --git a/docs/insomnia/get-started/install.md b/docs/insomnia/get-started/install.md
index d89ba22..4b2fae6 100644
--- a/docs/insomnia/get-started/install.md
+++ b/docs/insomnia/get-started/install.md
@@ -3,13 +3,11 @@ layout: article-detail
 title:  Install Insomnia
 ---
 
-<!-- for rework: revise this page like we normally would -->
-
 Insomnia is available on macOS, Windows, and Linux. If you haven't already downloaded Insomnia, visit the [Download Page](https://insomnia.rest/download).
 
 <nav>
   <div class="nav nav-tabs" id="nav-tab" role="tablist">
-    <button class="nav-link active side-tabs" id="nav-home-tab" data-bs-toggle="tab" data-bs-target="#nav-home" type="button" role="tab" aria-controls="nav-home" aria-selected="true">MacOS</button>
+    <button class="nav-link active side-tabs" id="nav-home-tab" data-bs-toggle="tab" data-bs-target="#nav-home" type="button" role="tab" aria-controls="nav-home" aria-selected="true">macOS</button>
     <button class="nav-link side-tabs" id="nav-profile-tab" data-bs-toggle="tab" data-bs-target="#nav-profile" type="button" role="tab" aria-controls="nav-profile" aria-selected="false">Windows</button>
     <button class="nav-link side-tabs" id="nav-contact-tab" data-bs-toggle="tab" data-bs-target="#nav-contact" type="button" role="tab" aria-controls="nav-contact" aria-selected="false">Linux</button>
   </div>
@@ -19,65 +17,55 @@ Insomnia is available on macOS, Windows, and Linux. If you haven't already downl
     <div class="alert alert-primary">
     <b>Note</b>: The minimum macOS version supported is macOS 10.12 Sierra.
     </div>
-    Get Insomnia on macOS <a href="https://insomnia.rest/download">here</a>, or by using Brew.
-<br/><br/>
-<a href="https://insomnia.rest/download">Download</a> and double-click the disk image. When prompted, drag Insomnia to your <b>Applications</b> folder. This ensures future updates can be installed correctly.
-<br/><br/>
-macOS users can also install Insomnia using <a href="https://brew.sh/">Brew Cask</a> via the Insomnia package:
+    <a href="https://insomnia.rest/download">Download Insomnia on macOS</a> or use <a href="https://brew.sh/">Homebrew</a>:
 <br/><br/>
 <pre class="highlight"><code>brew install --cask insomnia</code></pre>
   </div>
   <div class="tab-pane fade" id="nav-profile" role="tabpanel" aria-labelledby="nav-profile-tab">
-Get Insomnia on Windows <a href="https://insomnia.rest/download">here</a>.
-<br/><br/>
-The Windows application is a generic installer <code>.exe</code>. Double click the installer file to install Insomnia in your existing filesystem. This option is recommended, as it will enable automatic app updates.
-<br/><br/>
-<h3>Uninstall on Windows</h3>
-To uninstall Insomnia from a Windows computer, go to the settings menu on Windows and select <b>Apps</b>.
+<a href="https://insomnia.rest/download">Download Insomnia on Windows</a>
 <br/><br/>
-From the Add/Remove Programs section, click on the app and select to uninstall.
+The Windows application is a generic installer <code>.exe</code>.
   </div>
   <div class="tab-pane fade" id="nav-contact" role="tabpanel" aria-labelledby="nav-contact-tab">
-Insomnia runs on common Linux distributions.
+<h2>Ubuntu and Debian</h2>
+The Debian package apt repository can be added and installed using <code>apt-get</code>:
 <br/><br/>
-<h3>Ubuntu and Debian</h3>
 
-The Debian package apt repository can be added and installed using <code>apt-get</code>.
-<br/><br/>
-<pre class="highlight"><code># Add to sources
+1. Add the package to sources:
+<pre class="highlight"><code>
 curl -1sLf \
   'https://packages.konghq.com/public/insomnia/setup.deb.sh' \
   | sudo -E distro=ubuntu codename=focal bash
+</code></pre>
 
-
-# Refresh repository sources and install Insomnia
-
+2. Refresh repository sources and install Insomnia:
+<pre class="highlight"><code>
 sudo apt-get update
 sudo apt-get install insomnia
 </code></pre>
 
 You can also download the older <a href="https://cloudsmith.io/~kong/repos/insomnia-legacy">year-versioned Debian packages</a> or the <a href="https://cloudsmith.io/~kong/repos/insomnia">latest Debian packages</a> directly from our package hosting.
 <br/><br/>
-<h3>Snap</h3>
+<h2>Snap</h2>
 
-<a href="https://snapcraft.io/">Snap</a> is a new cross-platform package format that supports convenient auto-updates. You can view <a href="https://snapcraft.io/insomnia">Insomnia on Snapcraft</a> or install it directly with the following command.
+<a href="https://snapcraft.io/">Snap</a> is a cross-platform package format that supports convenient auto-updates. You can install <a href="https://snapcraft.io/insomnia">Insomnia on Snapcraft</a> or install it directly:
 <br/><br/>
 <pre class="highlight"><code>sudo snap install insomnia</code></pre>
 
-There's also an <a href="https://updates.insomnia.rest/downloads/release/latest?app=com.insomnia.app">AppImage package</a> that can be run directly as an executable.
+You can also run a <a href="https://updates.insomnia.rest/downloads/release/latest?app=com.insomnia.app">AppImage package</a> as an executable.
 <br/><br/>
 <h3>Troubleshooting Linux Installations</h3>
 
-Here are some issues that have caused problems for Linux users in the past:
+Use the following recommendations if you're encountering problems while installing Insomnia on Linux:
 <br/><br/>
 <ul>
-    <li><code>/tmp</code> folder must allow execution</li>
-    <li>After installed snap, you might need <a href="https://bugs.launchpad.net/ubuntu/+source/snapd/+bug/1631514"><code>systemctl restart snapd.service</code></a></li>
+    <li>The <code>/tmp</code> folder must allow execution</li>
+    <li>After installing Snap, you may need <a href="https://bugs.launchpad.net/ubuntu/+source/snapd/+bug/1631514"><code>systemctl restart snapd.service</code></a></li>
     <li>Insomnia is only compatible with 64-bit systems</li>
 </ul>
   </div>
 </div>
 
-## Previous Insomnia Versions
+## Install older Insomnia versions
 
-To roll back to a previous Insomnia version, download the version from [GitHub Releases](https://github.com/kong/insomnia/releases). This process is only intended for debugging and emergencies, as the app will try to update itself after it launches.
+To roll back to a previous Insomnia version, download the version from the [GitHub Releases](https://github.com/kong/insomnia/releases). This is only intended for debugging and emergencies, as the app will try to update itself after it launches.

From 96d853a78a0df14e89d896dc4388e337ba6e283d Mon Sep 17 00:00:00 2001
From: Diana <75819066+cloudjumpercat@users.noreply.github.com>
Date: Fri, 2 Aug 2024 11:59:18 -0500
Subject: [PATCH 8/8] docs(Get started rework): Revise the Insomnia allowlist
 page (#227)

* Revise the Insomnia allowlist page

Signed-off-by: Diana <75819066+cloudjumpercat@users.noreply.github.com>

* wip2

* Apply code review feedback

Signed-off-by: Diana <75819066+cloudjumpercat@users.noreply.github.com>

---------

Signed-off-by: Diana <75819066+cloudjumpercat@users.noreply.github.com>
Co-authored-by: Fabian Rodriguez <fabian.rodriguez@konghq.com>
---
 docs/assets/css/styles.scss                   |  4 +
 .../get-started/mock-server/allowlist.md      | 76 +++++--------------
 2 files changed, 23 insertions(+), 57 deletions(-)

diff --git a/docs/assets/css/styles.scss b/docs/assets/css/styles.scss
index 6741bfe..92159a5 100644
--- a/docs/assets/css/styles.scss
+++ b/docs/assets/css/styles.scss
@@ -18,6 +18,10 @@ body {
     }
 }
 
+table {
+  @extend .table;
+}
+
 // logo and icon styling
 #inso-logo {
     padding-left: 20px;
diff --git a/docs/insomnia/get-started/mock-server/allowlist.md b/docs/insomnia/get-started/mock-server/allowlist.md
index a9f38ca..bb7a65d 100644
--- a/docs/insomnia/get-started/mock-server/allowlist.md
+++ b/docs/insomnia/get-started/mock-server/allowlist.md
@@ -3,60 +3,22 @@ layout: article-detail
 title:  Allowlist for Insomnia
 ---
 
-<!-- for docs rework: revise this page like we normally would -->
-
-## Introduction
-
-For enterprise users utilizing Insomnia, it's crucial to ensure that specific domains are whitelisted in your network. This step is essential to guarantee that all features of Insomnia, including updates, synchronization, and documentation, work without any hindrance in environments with restricted internet access.
-
-## Domains to Whitelist
-
-To fully utilize Insomnia, please ensure the following domains are whitelisted:
-
-- **insomnia.rest**: Main website for Insomnia.
-
-- **ai.insomnia.rest**: Handles AI-related features within Insomnia.
-
-- **api.insomnia.rest**: API endpoint for Insomnia services.
-
-- **docs.insomnia.rest**: Provides access to Insomnia documentation and user guides.
-
-- **mock.insomnia.rest**: Used for Insomnia App's Mocking feature.
-
-- **updates.insomnia.rest**: For receiving software updates and patches.
-
-- **auth.insomnia.rest**: Manages authentication processes for Insomnia.
-
-- **insomnia-prod.us.auth0.com**: A domain linked to authentication used for secure logins.
-
-- **djvq2ky33rnc.cloudfront.net**: A CDN domain for hosting static assets related to Insomnia.
-
-- **api.segment.io**: Used for analytics and telemetry within Insomnia.
-
-- **o1147619.ingest.sentry.io**:  Used for error reporting and monitoring to enhance the application's stability and performance.
-
-## Whitelisting Steps
-
-### For IT Administrators
-
-Follow these steps to add the domains to your network's whitelist:
-
-1. **Access Firewall or Network Security Settings:**
-   - Log in to your firewall or web filter's administrative interface.
-
-2. **Find the Whitelisting Section:**
-   - Locate the area where you can list allowed websites or domains.
-
-3. **Input the Domains:**
-   - Add each of the above domains to the whitelist section. Ensure you save the changes after adding each domain.
-
-4. **Implement the Changes:**
-   - Apply the changes, which may necessitate restarting the firewall or web filter service.
-
-### For Individual Users
-
-If you're an individual user, contact your IT department with this list and request these domains be whitelisted to enable full functionality of Insomnia in your workspace.
-
-## Conclusion
-
-Whitelisting these domains ensures uninterrupted access to all functionalities of Insomnia, including updates, documentation, and necessary backend services. Should you experience issues post-whitelisting, it's advisable to seek assistance from your IT support or reach out to Insomnia's customer service at <support@insomnia.rest> OR <https://support.konghq.com/support/s/>.
+Ensure the following domains are allowlisted to use Insomnia:
+
+| Hostname | Description |
+| -------- | ----------- |
+| `insomnia.rest` | Main website for Insomnia. |
+| `ai.insomnia.rest` | Handles AI-related features in Insomnia. |
+| `api.insomnia.rest` | API endpoint for Insomnia services. |
+| `docs.insomnia.rest` | Provides access to Insomnia's documentation and user guides. |
+| `mock.insomnia.rest` | Used for the Insomnia app's [mocking feature](/insomnia/api-mocking). |
+| `updates.insomnia.rest` | For receiving software updates and patches. |
+| `auth.insomnia.rest` | Manages authentication processes for Insomnia. |
+| `insomnia-prod.us.auth0.com` | A domain linked to authentication used for secure logins. |
+| `djvq2ky33rnc.cloudfront.net` | A CDN domain for hosting static assets related to Insomnia. |
+| `api.segment.io` | Used for analytics and telemetry within Insomnia. |
+| `o1147619.ingest.sentry.io` | Used for error reporting and monitoring to enhance the application's stability and performance. |
+
+You might need to restart your firewall or web filter after adding these to the allowlist.
+
+If you have issues after allowlisting Insomnia hostnames, contact your IT support or reach out to Insomnia's customer service at <support@insomnia.rest> or <https://support.konghq.com/support/s/>.