From 6464eed2c047130e3ee611c4eb394e546b782cca Mon Sep 17 00:00:00 2001 From: hawkeyexl Date: Tue, 27 Jan 2026 10:43:20 -0800 Subject: [PATCH 1/8] chore: remove temporary Schema viewer component --- fern/pages/docs/actions/checkLink.mdx | 3 --- fern/pages/docs/actions/click.mdx | 3 --- fern/pages/docs/actions/dragAndDrop.mdx | 3 --- fern/pages/docs/actions/find.mdx | 3 --- fern/pages/docs/actions/goTo.mdx | 3 --- fern/pages/docs/actions/httpRequest.mdx | 3 --- fern/pages/docs/actions/loadCookie.mdx | 3 --- fern/pages/docs/actions/loadVariables.mdx | 3 --- fern/pages/docs/actions/record.mdx | 3 --- fern/pages/docs/actions/runCode.mdx | 3 --- fern/pages/docs/actions/runShell.mdx | 3 --- fern/pages/docs/actions/saveCookie.mdx | 3 --- fern/pages/docs/actions/screenshot.mdx | 3 --- fern/pages/docs/actions/stopRecord.mdx | 3 --- fern/pages/docs/actions/type.mdx | 3 --- fern/pages/docs/actions/wait.mdx | 3 --- 16 files changed, 48 deletions(-) diff --git a/fern/pages/docs/actions/checkLink.mdx b/fern/pages/docs/actions/checkLink.mdx index 3026344..784bee3 100644 --- a/fern/pages/docs/actions/checkLink.mdx +++ b/fern/pages/docs/actions/checkLink.mdx @@ -8,7 +8,6 @@ description: Check if a URL returns an acceptable status code from a GET request --- import { schemas } from "doc-detective-common"; -import JSONSchemaViewer from "@theme/JSONSchemaViewer"; The `checkLink` action checks if a URL returns an acceptable status code from a GET request. This action is useful for verifying that a hyperlink or image URL is valid. @@ -249,6 +248,4 @@ After applying these changes, the test should pass: } ``` -## Schema reference - diff --git a/fern/pages/docs/actions/click.mdx b/fern/pages/docs/actions/click.mdx index d16a5f3..9f0a632 100644 --- a/fern/pages/docs/actions/click.mdx +++ b/fern/pages/docs/actions/click.mdx @@ -8,7 +8,6 @@ description: Click or tap an element on the page. --- import { schemas } from "doc-detective-common"; -import JSONSchemaViewer from "@theme/JSONSchemaViewer"; The `click` action allows you to click or tap an element on the page. You can specify which mouse button to use and target elements using text or selectors. @@ -135,6 +134,4 @@ Here are a few ways you might use the `click` action: - [`find`](/docs/actions/find): Find an element and optionally interact with it - [`type`](/docs/actions/type): Type text or special keys -## Schema reference - diff --git a/fern/pages/docs/actions/dragAndDrop.mdx b/fern/pages/docs/actions/dragAndDrop.mdx index fbe5a3d..15fa5c8 100644 --- a/fern/pages/docs/actions/dragAndDrop.mdx +++ b/fern/pages/docs/actions/dragAndDrop.mdx @@ -8,7 +8,6 @@ description: Drag an element to a target location. --- import { schemas } from "doc-detective-common"; -import JSONSchemaViewer from "@theme/JSONSchemaViewer"; The `dragAndDrop` action allows you to drag an element and drop it at a target location. This is useful for testing drag-and-drop interfaces, reordering lists, moving items between containers, and other interactive UI elements. @@ -104,6 +103,4 @@ Here are several ways you might use the `dragAndDrop` action: - [`find`](/docs/actions/find): Locate elements before performing other actions - [`wait`](/docs/actions/wait): Add delays for animations to complete -## Schema reference - diff --git a/fern/pages/docs/actions/find.mdx b/fern/pages/docs/actions/find.mdx index 23d9070..32f08f9 100644 --- a/fern/pages/docs/actions/find.mdx +++ b/fern/pages/docs/actions/find.mdx @@ -8,7 +8,6 @@ description: Locate and interact with an element on the page. --- import { schemas } from "doc-detective-common"; -import JSONSchemaViewer from "@theme/JSONSchemaViewer"; The `find` action locates an element in the current interface based on its display text or a CSS/XPath selector. After finding the element, you can optionally interact with it, such as clicking it or typing into it. @@ -170,6 +169,4 @@ Here are a few ways you might use the `find` action: } ``` -## Schema reference - diff --git a/fern/pages/docs/actions/goTo.mdx b/fern/pages/docs/actions/goTo.mdx index 7c0218f..3baabfc 100644 --- a/fern/pages/docs/actions/goTo.mdx +++ b/fern/pages/docs/actions/goTo.mdx @@ -8,7 +8,6 @@ description: Navigate to a specified URL. --- import { schemas } from "doc-detective-common"; -import JSONSchemaViewer from "@theme/JSONSchemaViewer"; The `goTo` action navigates the browser to a specified URL. This is typically used to start a test at a specific page or navigate between pages during a test. @@ -220,6 +219,4 @@ Use multiple wait conditions together with a custom timeout. } ``` -## Schema reference - diff --git a/fern/pages/docs/actions/httpRequest.mdx b/fern/pages/docs/actions/httpRequest.mdx index 2bf5513..40a9245 100644 --- a/fern/pages/docs/actions/httpRequest.mdx +++ b/fern/pages/docs/actions/httpRequest.mdx @@ -8,7 +8,6 @@ description: Perform a generic HTTP request, for example to an API. --- import { schemas } from "doc-detective-common"; -import JSONSchemaViewer from "@theme/JSONSchemaViewer"; The `httpRequest` action makes arbitrary HTTP calls, allowing you to interact with and validate APIs or other web services directly within your tests. @@ -390,6 +389,4 @@ You can use both `response.required` and `response.body` together to validate th > **Note:** Fields with `null`, `""`, `0`, or `false` values are considered to exist and will pass validation. -## Schema reference - diff --git a/fern/pages/docs/actions/loadCookie.mdx b/fern/pages/docs/actions/loadCookie.mdx index 3905e5b..23cf419 100644 --- a/fern/pages/docs/actions/loadCookie.mdx +++ b/fern/pages/docs/actions/loadCookie.mdx @@ -8,7 +8,6 @@ description: Load a cookie from a file or environment variable into the browser. --- import { schemas } from "doc-detective-common"; -import JSONSchemaViewer from "@theme/JSONSchemaViewer"; The `loadCookie` action loads a cookie from a file or environment variable into the browser. This action is useful for restoring authentication sessions, user preferences, or other stateful information that was previously saved using the [`saveCookie`](/docs/actions/save-cookie) action. @@ -195,6 +194,4 @@ Load a cookie with detailed configuration: - [`saveCookie`](/docs/actions/save-cookie): Save a browser cookie to a file or environment variable - [`loadVariables`](/docs/actions/load-variables): Load environment variables from .env files -## Schema reference - diff --git a/fern/pages/docs/actions/loadVariables.mdx b/fern/pages/docs/actions/loadVariables.mdx index 0cdaf13..bc9fd2e 100644 --- a/fern/pages/docs/actions/loadVariables.mdx +++ b/fern/pages/docs/actions/loadVariables.mdx @@ -8,7 +8,6 @@ description: Load environment variables from a .env file. --- import { schemas } from "doc-detective-common"; -import JSONSchemaViewer from "@theme/JSONSchemaViewer"; The `loadVariables` action loads environment variables from a specified `.env` file. This action is useful for accessing sensitive information, such as API keys or other credentials, without hardcoding them into your tests. Variables loaded this way are available for use in subsequent steps within the same test. @@ -54,6 +53,4 @@ You can load these variables using the `loadVariables` action: } ``` -## Schema reference - diff --git a/fern/pages/docs/actions/record.mdx b/fern/pages/docs/actions/record.mdx index e2ccf20..53224cb 100644 --- a/fern/pages/docs/actions/record.mdx +++ b/fern/pages/docs/actions/record.mdx @@ -8,7 +8,6 @@ description: Start capturing a video of test execution. --- import { schemas } from "doc-detective-common"; -import JSONSchemaViewer from "@theme/JSONSchemaViewer"; The `record` action starts recording the browser viewport as a video file (MP4, WebM, or GIF). This is useful for debugging failed tests or creating multimedia documentation. Recording continues until a `stopRecord` step is encountered. @@ -116,6 +115,4 @@ Records to `test_video.gif` in the `output/gifs` directory, overwriting if it ex } ``` -## Schema reference - diff --git a/fern/pages/docs/actions/runCode.mdx b/fern/pages/docs/actions/runCode.mdx index 37cd656..8b09ec2 100644 --- a/fern/pages/docs/actions/runCode.mdx +++ b/fern/pages/docs/actions/runCode.mdx @@ -8,7 +8,6 @@ description: Assemble and run code snippets in various languages. --- import { schemas } from "doc-detective-common"; -import JSONSchemaViewer from "@theme/JSONSchemaViewer"; The `runCode` action executes a code snippet in a specified language (like JavaScript, Python, Bash, etc.) on the local machine and evaluates the results. This allows embedding executable code directly within your tests. @@ -146,6 +145,4 @@ The first step runs Python code to print "setup", validates the output using a r } ``` -## Schema reference - diff --git a/fern/pages/docs/actions/runShell.mdx b/fern/pages/docs/actions/runShell.mdx index 21a0919..99ab140 100644 --- a/fern/pages/docs/actions/runShell.mdx +++ b/fern/pages/docs/actions/runShell.mdx @@ -8,7 +8,6 @@ description: Perform a native shell command. --- import { schemas } from "doc-detective-common"; -import JSONSchemaViewer from "@theme/JSONSchemaViewer"; The `runShell` action runs a shell command or script on the local machine and evaluates the results, extending Doc Detective's testing capabilities to anything you can script. @@ -157,6 +156,4 @@ The first step echoes "setup", validates the output using a regex, and captures } ``` -## Schema reference - diff --git a/fern/pages/docs/actions/saveCookie.mdx b/fern/pages/docs/actions/saveCookie.mdx index 81f8d8e..dd922d4 100644 --- a/fern/pages/docs/actions/saveCookie.mdx +++ b/fern/pages/docs/actions/saveCookie.mdx @@ -8,7 +8,6 @@ description: Save a browser cookie to a file or environment variable for later r --- import { schemas } from "doc-detective-common"; -import JSONSchemaViewer from "@theme/JSONSchemaViewer"; The `saveCookie` action saves a browser cookie to a file or environment variable for later reuse. This action is useful for preserving authentication sessions, user preferences, or other stateful information between test runs or across different tests. @@ -153,6 +152,4 @@ Save a cookie with detailed configuration: - [`loadVariables`](/docs/actions/load-variables): Load environment variables from .env files -## Schema reference - diff --git a/fern/pages/docs/actions/screenshot.mdx b/fern/pages/docs/actions/screenshot.mdx index 9bc389b..83608f7 100644 --- a/fern/pages/docs/actions/screenshot.mdx +++ b/fern/pages/docs/actions/screenshot.mdx @@ -8,7 +8,6 @@ description: Take a screenshot in PNG format and optionally perform visual regre --- import { schemas } from "doc-detective-common"; -import JSONSchemaViewer from "@theme/JSONSchemaViewer"; The `screenshot` action captures a PNG image of the current browser viewport or a specific element. It can also perform visual regression testing by comparing the captured image against a previously saved reference image. @@ -148,6 +147,4 @@ Captures the element with text "Submit Button", adds 10px padding, and compares } ``` -## Schema reference - diff --git a/fern/pages/docs/actions/stopRecord.mdx b/fern/pages/docs/actions/stopRecord.mdx index 697e2ac..8b06117 100644 --- a/fern/pages/docs/actions/stopRecord.mdx +++ b/fern/pages/docs/actions/stopRecord.mdx @@ -8,7 +8,6 @@ description: Stop capturing a video of test execution. --- import { schemas } from "doc-detective-common"; -import JSONSchemaViewer from "@theme/JSONSchemaViewer"; The `stopRecord` action stops a video recording previously started by a [`record`](record) action and saves the video file. @@ -47,6 +46,4 @@ This example starts recording, performs an action, and then stops the recording. } ``` -## Schema reference - diff --git a/fern/pages/docs/actions/type.mdx b/fern/pages/docs/actions/type.mdx index 0d7f607..4dc4781 100644 --- a/fern/pages/docs/actions/type.mdx +++ b/fern/pages/docs/actions/type.mdx @@ -8,7 +8,6 @@ description: Type keys, including special keys like Enter. --- import { schemas } from "doc-detective-common"; -import JSONSchemaViewer from "@theme/JSONSchemaViewer"; The `type` action simulates key presses, including special keys such as Enter. This action is useful for simulating user input, such as filling out a form, navigating a website, or using keyboard shortcuts. It typically requires a preceding `find` or `click` action to focus an input element. @@ -193,6 +192,4 @@ Here's a list of special keys you can use: } ``` -## Schema reference - diff --git a/fern/pages/docs/actions/wait.mdx b/fern/pages/docs/actions/wait.mdx index dfc503d..6b7438b 100644 --- a/fern/pages/docs/actions/wait.mdx +++ b/fern/pages/docs/actions/wait.mdx @@ -8,7 +8,6 @@ description: Pause before performing the next action. --- import { schemas } from "doc-detective-common"; -import JSONSchemaViewer from "@theme/JSONSchemaViewer"; The `wait` action pauses test execution for a specified duration before proceeding to the next step. This is useful for adding delays, for example, to allow time for animations to complete or to make recordings easier to follow. @@ -71,6 +70,4 @@ The value assigned to the `wait` key is the duration to pause in milliseconds. Y } ``` -## Schema reference - From ee0191a1027a1d4197522dc6cddb2678895c2ade Mon Sep 17 00:00:00 2001 From: hawkeyexl Date: Tue, 27 Jan 2026 10:46:59 -0800 Subject: [PATCH 2/8] fix: remove unused schemas import --- fern/pages/docs/actions/checkLink.mdx | 1 - fern/pages/docs/actions/click.mdx | 1 - fern/pages/docs/actions/dragAndDrop.mdx | 1 - fern/pages/docs/actions/find.mdx | 1 - fern/pages/docs/actions/goTo.mdx | 1 - fern/pages/docs/actions/httpRequest.mdx | 1 - fern/pages/docs/actions/loadCookie.mdx | 1 - fern/pages/docs/actions/loadVariables.mdx | 1 - fern/pages/docs/actions/record.mdx | 1 - fern/pages/docs/actions/runCode.mdx | 1 - fern/pages/docs/actions/runShell.mdx | 1 - fern/pages/docs/actions/saveCookie.mdx | 1 - fern/pages/docs/actions/screenshot.mdx | 1 - fern/pages/docs/actions/stopRecord.mdx | 1 - fern/pages/docs/actions/type.mdx | 1 - fern/pages/docs/actions/wait.mdx | 1 - 16 files changed, 16 deletions(-) diff --git a/fern/pages/docs/actions/checkLink.mdx b/fern/pages/docs/actions/checkLink.mdx index 784bee3..939b398 100644 --- a/fern/pages/docs/actions/checkLink.mdx +++ b/fern/pages/docs/actions/checkLink.mdx @@ -7,7 +7,6 @@ grand_parent: Tests, description: Check if a URL returns an acceptable status code from a GET request. --- -import { schemas } from "doc-detective-common"; The `checkLink` action checks if a URL returns an acceptable status code from a GET request. This action is useful for verifying that a hyperlink or image URL is valid. diff --git a/fern/pages/docs/actions/click.mdx b/fern/pages/docs/actions/click.mdx index 9f0a632..edcd2e5 100644 --- a/fern/pages/docs/actions/click.mdx +++ b/fern/pages/docs/actions/click.mdx @@ -7,7 +7,6 @@ grand_parent: Tests description: Click or tap an element on the page. --- -import { schemas } from "doc-detective-common"; The `click` action allows you to click or tap an element on the page. You can specify which mouse button to use and target elements using text or selectors. diff --git a/fern/pages/docs/actions/dragAndDrop.mdx b/fern/pages/docs/actions/dragAndDrop.mdx index 15fa5c8..e0154c9 100644 --- a/fern/pages/docs/actions/dragAndDrop.mdx +++ b/fern/pages/docs/actions/dragAndDrop.mdx @@ -7,7 +7,6 @@ grand_parent: Tests description: Drag an element to a target location. --- -import { schemas } from "doc-detective-common"; The `dragAndDrop` action allows you to drag an element and drop it at a target location. This is useful for testing drag-and-drop interfaces, reordering lists, moving items between containers, and other interactive UI elements. diff --git a/fern/pages/docs/actions/find.mdx b/fern/pages/docs/actions/find.mdx index 32f08f9..34dda40 100644 --- a/fern/pages/docs/actions/find.mdx +++ b/fern/pages/docs/actions/find.mdx @@ -7,7 +7,6 @@ grand_parent: Tests description: Locate and interact with an element on the page. --- -import { schemas } from "doc-detective-common"; The `find` action locates an element in the current interface based on its display text or a CSS/XPath selector. After finding the element, you can optionally interact with it, such as clicking it or typing into it. diff --git a/fern/pages/docs/actions/goTo.mdx b/fern/pages/docs/actions/goTo.mdx index 3baabfc..17e43e2 100644 --- a/fern/pages/docs/actions/goTo.mdx +++ b/fern/pages/docs/actions/goTo.mdx @@ -7,7 +7,6 @@ grand_parent: Tests description: Navigate to a specified URL. --- -import { schemas } from "doc-detective-common"; The `goTo` action navigates the browser to a specified URL. This is typically used to start a test at a specific page or navigate between pages during a test. diff --git a/fern/pages/docs/actions/httpRequest.mdx b/fern/pages/docs/actions/httpRequest.mdx index 40a9245..cfbb2ac 100644 --- a/fern/pages/docs/actions/httpRequest.mdx +++ b/fern/pages/docs/actions/httpRequest.mdx @@ -7,7 +7,6 @@ grand_parent: Tests description: Perform a generic HTTP request, for example to an API. --- -import { schemas } from "doc-detective-common"; The `httpRequest` action makes arbitrary HTTP calls, allowing you to interact with and validate APIs or other web services directly within your tests. diff --git a/fern/pages/docs/actions/loadCookie.mdx b/fern/pages/docs/actions/loadCookie.mdx index 23cf419..4c35464 100644 --- a/fern/pages/docs/actions/loadCookie.mdx +++ b/fern/pages/docs/actions/loadCookie.mdx @@ -7,7 +7,6 @@ grand_parent: Tests description: Load a cookie from a file or environment variable into the browser. --- -import { schemas } from "doc-detective-common"; The `loadCookie` action loads a cookie from a file or environment variable into the browser. This action is useful for restoring authentication sessions, user preferences, or other stateful information that was previously saved using the [`saveCookie`](/docs/actions/save-cookie) action. diff --git a/fern/pages/docs/actions/loadVariables.mdx b/fern/pages/docs/actions/loadVariables.mdx index bc9fd2e..c619ed6 100644 --- a/fern/pages/docs/actions/loadVariables.mdx +++ b/fern/pages/docs/actions/loadVariables.mdx @@ -7,7 +7,6 @@ grand_parent: Tests description: Load environment variables from a .env file. --- -import { schemas } from "doc-detective-common"; The `loadVariables` action loads environment variables from a specified `.env` file. This action is useful for accessing sensitive information, such as API keys or other credentials, without hardcoding them into your tests. Variables loaded this way are available for use in subsequent steps within the same test. diff --git a/fern/pages/docs/actions/record.mdx b/fern/pages/docs/actions/record.mdx index 53224cb..f88e4bc 100644 --- a/fern/pages/docs/actions/record.mdx +++ b/fern/pages/docs/actions/record.mdx @@ -7,7 +7,6 @@ grand_parent: Tests description: Start capturing a video of test execution. --- -import { schemas } from "doc-detective-common"; The `record` action starts recording the browser viewport as a video file (MP4, WebM, or GIF). This is useful for debugging failed tests or creating multimedia documentation. Recording continues until a `stopRecord` step is encountered. diff --git a/fern/pages/docs/actions/runCode.mdx b/fern/pages/docs/actions/runCode.mdx index 8b09ec2..fca0940 100644 --- a/fern/pages/docs/actions/runCode.mdx +++ b/fern/pages/docs/actions/runCode.mdx @@ -7,7 +7,6 @@ grand_parent: Tests description: Assemble and run code snippets in various languages. --- -import { schemas } from "doc-detective-common"; The `runCode` action executes a code snippet in a specified language (like JavaScript, Python, Bash, etc.) on the local machine and evaluates the results. This allows embedding executable code directly within your tests. diff --git a/fern/pages/docs/actions/runShell.mdx b/fern/pages/docs/actions/runShell.mdx index 99ab140..6b2af52 100644 --- a/fern/pages/docs/actions/runShell.mdx +++ b/fern/pages/docs/actions/runShell.mdx @@ -7,7 +7,6 @@ grand_parent: Tests description: Perform a native shell command. --- -import { schemas } from "doc-detective-common"; The `runShell` action runs a shell command or script on the local machine and evaluates the results, extending Doc Detective's testing capabilities to anything you can script. diff --git a/fern/pages/docs/actions/saveCookie.mdx b/fern/pages/docs/actions/saveCookie.mdx index dd922d4..0b095cd 100644 --- a/fern/pages/docs/actions/saveCookie.mdx +++ b/fern/pages/docs/actions/saveCookie.mdx @@ -7,7 +7,6 @@ grand_parent: Tests description: Save a browser cookie to a file or environment variable for later reuse. --- -import { schemas } from "doc-detective-common"; The `saveCookie` action saves a browser cookie to a file or environment variable for later reuse. This action is useful for preserving authentication sessions, user preferences, or other stateful information between test runs or across different tests. diff --git a/fern/pages/docs/actions/screenshot.mdx b/fern/pages/docs/actions/screenshot.mdx index 83608f7..ef87b87 100644 --- a/fern/pages/docs/actions/screenshot.mdx +++ b/fern/pages/docs/actions/screenshot.mdx @@ -7,7 +7,6 @@ grand_parent: Tests description: Take a screenshot in PNG format and optionally perform visual regression testing. --- -import { schemas } from "doc-detective-common"; The `screenshot` action captures a PNG image of the current browser viewport or a specific element. It can also perform visual regression testing by comparing the captured image against a previously saved reference image. diff --git a/fern/pages/docs/actions/stopRecord.mdx b/fern/pages/docs/actions/stopRecord.mdx index 8b06117..89e31e4 100644 --- a/fern/pages/docs/actions/stopRecord.mdx +++ b/fern/pages/docs/actions/stopRecord.mdx @@ -7,7 +7,6 @@ grand_parent: Tests description: Stop capturing a video of test execution. --- -import { schemas } from "doc-detective-common"; The `stopRecord` action stops a video recording previously started by a [`record`](record) action and saves the video file. diff --git a/fern/pages/docs/actions/type.mdx b/fern/pages/docs/actions/type.mdx index 4dc4781..737a36c 100644 --- a/fern/pages/docs/actions/type.mdx +++ b/fern/pages/docs/actions/type.mdx @@ -7,7 +7,6 @@ grand_parent: Tests description: Type keys, including special keys like Enter. --- -import { schemas } from "doc-detective-common"; The `type` action simulates key presses, including special keys such as Enter. This action is useful for simulating user input, such as filling out a form, navigating a website, or using keyboard shortcuts. It typically requires a preceding `find` or `click` action to focus an input element. diff --git a/fern/pages/docs/actions/wait.mdx b/fern/pages/docs/actions/wait.mdx index 6b7438b..125b104 100644 --- a/fern/pages/docs/actions/wait.mdx +++ b/fern/pages/docs/actions/wait.mdx @@ -7,7 +7,6 @@ grand_parent: Tests description: Pause before performing the next action. --- -import { schemas } from "doc-detective-common"; The `wait` action pauses test execution for a specified duration before proceeding to the next step. This is useful for adding delays, for example, to allow time for animations to complete or to make recordings easier to follow. From e246a5d50c898f989615a71db703d3e893bbec96 Mon Sep 17 00:00:00 2001 From: hawkeyexl Date: Tue, 27 Jan 2026 10:48:51 -0800 Subject: [PATCH 3/8] chore: remove auto-generated schema reference files --- ...lof-1--goto-anyof-1--waituntil-2e1bb8d9.md | 30 ------------------- ...--goto-anyof-1--waituntil-find-10f35ec9.md | 25 ---------------- 2 files changed, 55 deletions(-) delete mode 100644 fern/pages/reference/schemas/filetypes-anyof-0--array-anyof-1--markup-array-actions-anyof-1--array-anyof-1--anyof-3--allof-1--goto-anyof-1--waituntil-2e1bb8d9.md delete mode 100644 fern/pages/reference/schemas/filetypes-anyof-0--array-anyof-1--markup-array-actions-anyof-1--array-anyof-1--anyof-3--allof-1--goto-anyof-1--waituntil-find-10f35ec9.md diff --git a/fern/pages/reference/schemas/filetypes-anyof-0--array-anyof-1--markup-array-actions-anyof-1--array-anyof-1--anyof-3--allof-1--goto-anyof-1--waituntil-2e1bb8d9.md b/fern/pages/reference/schemas/filetypes-anyof-0--array-anyof-1--markup-array-actions-anyof-1--array-anyof-1--anyof-3--allof-1--goto-anyof-1--waituntil-2e1bb8d9.md deleted file mode 100644 index 94013ff..0000000 --- a/fern/pages/reference/schemas/filetypes-anyof-0--array-anyof-1--markup-array-actions-anyof-1--array-anyof-1--anyof-3--allof-1--goto-anyof-1--waituntil-2e1bb8d9.md +++ /dev/null @@ -1,30 +0,0 @@ ---- -title: "fileTypes-anyOf[0]-array-anyOf[1]-markup-array-actions-anyOf[1]-array-anyOf[1]-anyOf[3]-allOf[1]-goTo-anyOf[1]-waitUntil-2e1bb8d9" ---- - -Configuration for waiting conditions after navigation. - -## Referenced In - -- [Go to URL (detailed)](/reference/schemas/go-to-url-detailed) - -## Fields - -Field | Type | Description | Default -:-- | :-- | :-- | :-- -networkIdleTime | one of:
- integer
- null | Optional. Wait for network activity to be idle (no new requests) for this duration in milliseconds. Set to `null` to skip this check. | `500` -domIdleTime | one of:
- integer
- null | Optional. Wait for DOM mutations to stop for this duration in milliseconds. Set to `null` to skip this check. | `1000` -find | object | Optional. Wait for a specific element to be present in the DOM. At least one of selector or elementText must be specified. | - -## Examples - -```json -{ - "networkIdleTime": 500, - "domIdleTime": 1000, - "find": { - "selector": "example", - "elementText": "example" - } -} -``` diff --git a/fern/pages/reference/schemas/filetypes-anyof-0--array-anyof-1--markup-array-actions-anyof-1--array-anyof-1--anyof-3--allof-1--goto-anyof-1--waituntil-find-10f35ec9.md b/fern/pages/reference/schemas/filetypes-anyof-0--array-anyof-1--markup-array-actions-anyof-1--array-anyof-1--anyof-3--allof-1--goto-anyof-1--waituntil-find-10f35ec9.md deleted file mode 100644 index d257364..0000000 --- a/fern/pages/reference/schemas/filetypes-anyof-0--array-anyof-1--markup-array-actions-anyof-1--array-anyof-1--anyof-3--allof-1--goto-anyof-1--waituntil-find-10f35ec9.md +++ /dev/null @@ -1,25 +0,0 @@ ---- -title: "fileTypes-anyOf[0]-array-anyOf[1]-markup-array-actions-anyOf[1]-array-anyOf[1]-anyOf[3]-allOf[1]-goTo-anyOf[1]-waitUntil-find-10f35ec9" ---- - -Wait for a specific element to be present in the DOM. At least one of selector or elementText must be specified. - -## Referenced In - -- [fileTypes-anyOf[0]-array-anyOf[1]-markup-array-actions-anyOf[1]-array-anyOf[1]-anyOf[3]-allOf[1]-goTo-anyOf[1]-waitUntil-2e1bb8d9](/reference/schemas/filetypes-anyof-0--array-anyof-1--markup-array-actions-anyof-1--array-anyof-1--anyof-3--allof-1--goto-anyof-1--waituntil-2e1bb8d9) - -## Fields - -Field | Type | Description | Default -:-- | :-- | :-- | :-- -selector | string | Optional. CSS selector for the element to wait for. | -elementText | string | Optional. Text content the element must contain. | - -## Examples - -```json -{ - "selector": "example", - "elementText": "example" -} -``` From 000cae6140c8aec579dc30e105b4a7ce462e3d45 Mon Sep 17 00:00:00 2001 From: hawkeyexl Date: Tue, 27 Jan 2026 10:52:11 -0800 Subject: [PATCH 4/8] fix: convert Docusaurus admonitions to Fern components --- .../contribute/standard-contributions.mdx | 40 +++++++++---------- fern/pages/contribute/templates/feature.mdx | 5 ++- 2 files changed, 23 insertions(+), 22 deletions(-) diff --git a/fern/pages/contribute/standard-contributions.mdx b/fern/pages/contribute/standard-contributions.mdx index e5beba5..defdecd 100644 --- a/fern/pages/contribute/standard-contributions.mdx +++ b/fern/pages/contribute/standard-contributions.mdx @@ -140,55 +140,55 @@ Highlight important information with admonitions. Make sure you use the appropri ```markdown title="Note syntax" - :::note + `note` is for information that the user should be aware of but isn't critical. - ::: + ``` - :::note + `note` is for information that the user should be aware of but isn't critical. - ::: + ```markdown title="Tip syntax" - :::tip + `tip` is for useful advice or shortcuts that can help the user. - ::: + ``` - :::tip + `tip` is for useful advice or shortcuts that can help the user. - ::: + ```markdown title="Info syntax" - :::info + `info` is for useful information that isn't critical but may help the user. - ::: + ``` - :::info + `info` is for useful information that isn't critical but may help the user. - ::: + ```markdown title="Warning syntax" - :::warning + `warning` should be used when an action may be difficult to undo or may cost the user unexpected time or resources. - ::: + ``` - :::warning + `warning` should be used when an action may be difficult to undo or may cost the user unexpected time or resources. - ::: + ```markdown title="Danger syntax" - :::danger + `danger` should be used when there's a risk of data loss, unexpected cost, or harm. - ::: + ``` - :::danger + `danger` should be used when there's a risk of data loss, unexpected cost, or harm. - ::: + diff --git a/fern/pages/contribute/templates/feature.mdx b/fern/pages/contribute/templates/feature.mdx index 2cb1400..a9c40f4 100644 --- a/fern/pages/contribute/templates/feature.mdx +++ b/fern/pages/contribute/templates/feature.mdx @@ -234,10 +234,11 @@ Be explicit about what breaks: If behavior varies by version: ```markdown -:::info Version differences This feature works differently depending on your Doc Detective version: + +This feature works differently depending on your Doc Detective version: **v2.x:** Uses `oldOption` **v3.x and later:** Uses `newOption` -::: + ``` ## Example feature documentation From 3262edbbb2e0eba097f752926e07e78093fae2cc Mon Sep 17 00:00:00 2001 From: hawkeyexl Date: Tue, 27 Jan 2026 10:59:43 -0800 Subject: [PATCH 5/8] feat: implement landing page structure --- fern/assets/images/landing/hero.png | Bin 0 -> 9730 bytes fern/pages/index.mdx | 54 ++++++++++++++++++++++++++-- 2 files changed, 51 insertions(+), 3 deletions(-) create mode 100644 fern/assets/images/landing/hero.png diff --git a/fern/assets/images/landing/hero.png b/fern/assets/images/landing/hero.png new file mode 100644 index 0000000000000000000000000000000000000000..4ce478a15ef5cefd37c2a8f165d75050749a1491 GIT binary patch literal 9730 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 literal 0 HcmV?d00001 diff --git a/fern/pages/index.mdx b/fern/pages/index.mdx index d6ce2bd..d611149 100644 --- a/fern/pages/index.mdx +++ b/fern/pages/index.mdx @@ -1,11 +1,59 @@ --- +layout: overview title: Doc Detective -subtitle: Keep your docs in sync with your product. Always. -headline: "Doc Detective | Documentation" +subtitle: Keep your docs accurate and up-to-date +description: Doc Detective is a documentation testing framework that ensures your docs are always right. slug: / hide-nav-links: false hide-feedback: true hide-page-actions: true --- -Home page content. +Doc Detective Hero Image + +# Keep your docs accurate and up-to-date + +Doc Detective is a documentation testing framework that ensures your docs are always right. + +[Get Started](/docs/get-started/installation) • [View on GitHub](https://github.com/doc-detective/doc-detective) + +## Features + + + + Test CLI commands, API calls, and UI actions directly from your documentation. + + + Write tests in Markdown or JSON alongside your docs to keep them in sync. + + + Run tests automatically in your CI/CD pipeline to prevent regressions. + + + +## Simple, Readable Tests + +Write tests that look like documentation. + +```json +{ + "tests": [ + { + "steps": [ + { + "action": "runShell", + "command": "echo 'Hello, World!'" + }, + { + "action": "checkLink", + "url": "https://google.com" + } + ] + } + ] +} +``` + +## Trusted by open source projects + +Doc Detective is used by teams who care about documentation quality. From 1927c2f4f91d0bf85563e14ac397467173dd6402 Mon Sep 17 00:00:00 2001 From: hawkeyexl Date: Thu, 29 Jan 2026 18:23:09 -0800 Subject: [PATCH 6/8] fix: update GitHub link in footer and modify index page content - Change GitHub link in footer to point to the correct repository. - Revise content on the index page for clarity and engagement. - Add buttons for user actions and enhance documentation structure. - Introduce new sections to improve user guidance and experience. --- fern/docs.yml | 2 +- fern/pages/index.mdx | 94 +++++++++++++++++++++++++++----------------- package-lock.json | 17 ++++++++ package.json | 2 +- 4 files changed, 78 insertions(+), 37 deletions(-) create mode 100644 package-lock.json diff --git a/fern/docs.yml b/fern/docs.yml index d08d16d..582cbba 100644 --- a/fern/docs.yml +++ b/fern/docs.yml @@ -89,7 +89,7 @@ navbar-links: value: https://github.com/doc-detective/doc-detective footer-links: - github: https://github.com/your-org/your-repo + github: https://github.com/doc-detective linkedin: https://www.linkedin.com/company/doc-detective discord: https://discord.gg/2M7wXEThfF diff --git a/fern/pages/index.mdx b/fern/pages/index.mdx index d611149..37b02d3 100644 --- a/fern/pages/index.mdx +++ b/fern/pages/index.mdx @@ -9,51 +9,75 @@ hide-feedback: true hide-page-actions: true --- -Doc Detective Hero Image +## Document what actually works -# Keep your docs accurate and up-to-date +Doc Detective tests your documentation to make sure every command, example, and instruction still works, so your users don't get stuck. -Doc Detective is a documentation testing framework that ensures your docs are always right. + -[Get Started](/docs/get-started/installation) • [View on GitHub](https://github.com/doc-detective/doc-detective) +{/* Doc Detective Hero Image */} -## Features +{/* ## Powering teams that test what they publish - + + Ensuring their developer docs are always accurate. + + + Keeping community-contributed docs reliable and up-to-date. + + + Verifying onboarding docs stay current and helpful. + + */} + +## If code is tested, docs should be too + +Doc Detective performs your instructions step-by-step, just like your users would, and reports what works and what doesn't. + +## Taking the guesswork out of docs maintenance + + + Test CLI commands, API calls, and UI actions directly from your documentation. - - Write tests in Markdown or JSON alongside your docs to keep them in sync. + + Never take a manual screenshot again. - + Run tests automatically in your CI/CD pipeline to prevent regressions. -## Simple, Readable Tests - -Write tests that look like documentation. - -```json -{ - "tests": [ - { - "steps": [ - { - "action": "runShell", - "command": "echo 'Hello, World!'" - }, - { - "action": "checkLink", - "url": "https://google.com" - } - ] - } - ] -} -``` - -## Trusted by open source projects - -Doc Detective is used by teams who care about documentation quality. + +## How it works + +1. **Bring your docs.** Whether in Markdown, AsciiDoc, DITA, or other formats, Doc Detective can read them. +1. **Detect testable content.** Doc Detective scans commands, code blocks, and examples users are expected to run. +1. **Run the tests.** Each instruction is executed in a real environment to confirm it works as documented. +1. **Get actionable reports.** See what passed, what failed, and where your docs need updates. + +## Built for teams that value accuracy + + + + Ship with confidence knowing your docs match your code. + + + Verify accuracy without running every command manually. + + + Keep community-contributed docs reliable and up-to-date. + + + Make sure onboarding docs stay up-to-date and helpful. + + + +## Keep your documentation trustworthy + +Instead of assuming your docs still work, Doc Detective continuously verifies them by running real checks against real systems, catching issues before your users do. + +## Start catching documentation issues before your users do + + diff --git a/package-lock.json b/package-lock.json new file mode 100644 index 0000000..dd5622a --- /dev/null +++ b/package-lock.json @@ -0,0 +1,17 @@ +{ + "name": "doc-detective-docs", + "version": "1.0.0-beta", + "lockfileVersion": 3, + "requires": true, + "packages": { + "": { + "name": "doc-detective-docs", + "version": "1.0.0-beta", + "engines": { + "node": "^22.12.0 || ^24.11.1", + "npm": "^10.9.2 || ^11.6.2", + "pnpm": "^10.24.0" + } + } + } +} diff --git a/package.json b/package.json index fa4b0c6..c846df8 100644 --- a/package.json +++ b/package.json @@ -6,7 +6,7 @@ "scripts": { "setup": "npm i -g mdx2vast fern-api doc-detective@latest", "dev": "fern docs dev", - "test": "npx doc-detective@latest runTests" + "test": "npx doc-detective" }, "engines": { "node": "^22.12.0 || ^24.11.1", From 97b64f14978dd1c1db5ae449b3a70a42c0d1b2c0 Mon Sep 17 00:00:00 2001 From: hawkeyexl Date: Thu, 29 Jan 2026 18:23:47 -0800 Subject: [PATCH 7/8] fix: remove redundant section header from index page --- fern/pages/index.mdx | 2 -- 1 file changed, 2 deletions(-) diff --git a/fern/pages/index.mdx b/fern/pages/index.mdx index 37b02d3..2d87933 100644 --- a/fern/pages/index.mdx +++ b/fern/pages/index.mdx @@ -9,8 +9,6 @@ hide-feedback: true hide-page-actions: true --- -## Document what actually works - Doc Detective tests your documentation to make sure every command, example, and instruction still works, so your users don't get stuck. From 92e1933bd1c8fd351f47b5ae4da7cae6a7458888 Mon Sep 17 00:00:00 2001 From: hawkeyexl Date: Thu, 29 Jan 2026 18:32:16 -0800 Subject: [PATCH 8/8] update min node version --- fern/pages/contribute/local-development.mdx | 2 +- fern/pages/contribute/templates/tutorial.mdx | 2 +- fern/pages/contribute/testing.mdx | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/fern/pages/contribute/local-development.mdx b/fern/pages/contribute/local-development.mdx index 7a39688..9f7048e 100644 --- a/fern/pages/contribute/local-development.mdx +++ b/fern/pages/contribute/local-development.mdx @@ -32,7 +32,7 @@ For quick fixes (typos, small wording changes), use the [browser-based workflow] node --version ``` -Should show `v18.0.0` or higher. +Should show `v20.0.0` or higher. ## Fork and clone the repository diff --git a/fern/pages/contribute/templates/tutorial.mdx b/fern/pages/contribute/templates/tutorial.mdx index 2f0fb23..13d8e49 100644 --- a/fern/pages/contribute/templates/tutorial.mdx +++ b/fern/pages/contribute/templates/tutorial.mdx @@ -238,7 +238,7 @@ A test that: ## What you'll need -- Node.js 18 or later installed +- Node.js 20 or later installed - A text editor - 10 minutes diff --git a/fern/pages/contribute/testing.mdx b/fern/pages/contribute/testing.mdx index 047ee0d..cee3cda 100644 --- a/fern/pages/contribute/testing.mdx +++ b/fern/pages/contribute/testing.mdx @@ -479,7 +479,7 @@ If tests fail in CI but pass locally: 2. **Look for environment differences**: Paths, dependencies, timing 3. **Run tests in Docker** (mimics CI environment): ```bash - docker run --rm -v $(pwd):/app -w /app node:18 npm run doc-detective + docker run --rm -v $(pwd):/app -w /app node:20 npm run doc-detective ``` 4. **Ask for help**: Comment on the PR with the error details