From 2272d717ee9218dfd6cee2d347c7c4298ff96f57 Mon Sep 17 00:00:00 2001
From: "promptless[bot]" <179508745+promptless[bot]@users.noreply.github.com>
Date: Tue, 26 Aug 2025 13:57:40 +0000
Subject: [PATCH 1/2] Documentation updates from Promptless

---
 docs/get-started/installation.md | 2 +-
 package.json                     | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/get-started/installation.md b/docs/get-started/installation.md
index 8b4f2c0d..c4e72e8b 100644
--- a/docs/get-started/installation.md
+++ b/docs/get-started/installation.md
@@ -8,7 +8,7 @@ Downloading and running Doc Detective is straightforward. Follow these steps to
 
 1. Install prerequisites:
 
-   - [Node.js](https://nodejs.org/) v18 or later
+   - [Node.js](https://nodejs.org/) v18.20.0 or later
 
 2. In a terminal, install Doc Detective globally:
 
diff --git a/package.json b/package.json
index f9c15066..60afb1d5 100644
--- a/package.json
+++ b/package.json
@@ -75,6 +75,6 @@
     ]
   },
   "engines": {
-    "node": ">=18.0"
+    "node": ">=18.20.0"
   }
 }

From 5877c82c6f4b297251c97508944c2e7fa61a7c35 Mon Sep 17 00:00:00 2001
From: "promptless[bot]" <179508745+promptless[bot]@users.noreply.github.com>
Date: Tue, 14 Oct 2025 01:29:31 +0000
Subject: [PATCH 2/2] Sync documentation updates from Promptless agent

---
 docs/get-started/installation/index.mdx | 53 +++++++++++++++++++++++++
 package.json                            |  1 +
 2 files changed, 54 insertions(+)
 create mode 100644 docs/get-started/installation/index.mdx

diff --git a/docs/get-started/installation/index.mdx b/docs/get-started/installation/index.mdx
new file mode 100644
index 00000000..357eb8c3
--- /dev/null
+++ b/docs/get-started/installation/index.mdx
@@ -0,0 +1,53 @@
+---
+sidebar_label: Installation
+---
+
+import spec from "./sample.spec.json";
+import CodeBlock from '@theme/CodeBlock';
+
+# Installation
+
+Downloading and running Doc Detective is straightforward. Follow these steps to install Doc Detective and run your first test:
+
+1. Install prerequisites:
+
+    - [Node.js](https://nodejs.org/) v18.20.0 or later
+
+2. In a terminal, install Doc Detective globally:
+
+    <CodeBlock language="bash" title="Install Doc Detective">
+      npm i -g doc-detective
+    </CodeBlock>
+    {/* step runShell: "npm i -g doc-detective" */}
+
+    :::note
+
+    If you're working in a local copy of the `doc-detective` repository, you need to run `npm i` to install local dependencies.
+
+    :::
+
+3.  Save this file to your current directory as _sample.spec.json_:
+
+    <CodeBlock language="json" title="sample.spec.json">
+      {JSON.stringify(spec, null, 2)}
+    </CodeBlock>
+
+4. Run a test, pointing to the file you just created:
+
+    <CodeBlock language="bash" title="Run test">
+      npx doc-detective --input sample.spec.json
+    </CodeBlock>
+    {/* step runShell:
+    command: "npx doc-detective --input sample.spec.json"
+    workingDirectory: "." */}
+
+
+Congratulations! You've run your first test with Doc Detective. :tada:
+
+You should see output in the terminal indicating the progress and results of the test. Results are also saved in a `testResults-<timestamp>.json` file in the current directory (configurable with the `--output` option), and this test saves a screenshot to example.png:
+
+[![Sample test screenshot](./example.png)](./example.png)
+
+## Next steps
+
+Next up, take a look at some of the [concepts](/docs/get-started/concepts) native to Doc Detective, check out some of the guided [tutorials](/docs/category/tutorials), or explore how to write [tests](/docs/get-started/tests) and [actions](/docs/category/actions) to automate your documentation testing.
\ No newline at end of file
diff --git a/package.json b/package.json
index 60afb1d5..069eb7c6 100644
--- a/package.json
+++ b/package.json
@@ -32,6 +32,7 @@
     "@mui/material": "^7.3.1",
     "clsx": "^2.1.1",
     "doc-detective-common": "^3.3.0",
+    "docusaurus-json-schema-plugin": "^1.15.0",
     "dotenv": "^17.2.1",
     "https-browserify": "^1.0.0",
     "os-browserify": "^0.3.0",