From b96ce38a5b7d7ebf6be0e12c23bd57c899e80c09 Mon Sep 17 00:00:00 2001 From: "promptless[bot]" <179508745+promptless[bot]@users.noreply.github.com> Date: Thu, 26 Feb 2026 19:35:31 +0000 Subject: [PATCH 1/2] Document GitHub Action issue notifications and AI integrations --- fern/pages/contribute/repos/github-action.md | 42 ++++++++++++++++++++ 1 file changed, 42 insertions(+) diff --git a/fern/pages/contribute/repos/github-action.md b/fern/pages/contribute/repos/github-action.md index 5e50aee..c798525 100644 --- a/fern/pages/contribute/repos/github-action.md +++ b/fern/pages/contribute/repos/github-action.md @@ -5,3 +5,45 @@ title: github-action [`github-action`](https://github.com/doc-detective/github-action) runs Doc Detective in GitHub workflows. While Doc Detective can run in any CI/CD environment, this GitHub Action simplifies the process of running Doc Detective in GitHub workflows, provides a `results` object that can be used in subsequent steps, and offers handy features like creating GitHub issues for failed tests. This repo depends on [`doc-detective`](doc-detective) for performing the tests. + +## Issue notifications + +The GitHub Action can automatically create GitHub issues when tests fail. Set `create_issue_on_fail` to `true` to enable this. + +### Basic issue configuration + +- `create_issue_on_fail`: Creates a GitHub issue when any test fails. +- `issue_title`: Title of the created issue. Default: `"Doc Detective Failure"`. +- `issue_body`: Body of the issue. Supports these variables: + - `$RUN_URL`: URL of the workflow run that created the issue. + - `$RESULTS`: Test results as a JSON code block. + - `$PROMPT`: The prompt text (see below). +- `issue_labels`: Comma-separated list of labels to apply. +- `issue_assignees`: Comma-separated list of GitHub usernames to assign. + +### AI integrations + +Notify AI-powered integrations when issues are created to help investigate and fix failures faster. Use `integrations` to specify which integrations to notify. + +- `integrations`: Comma-separated list of integrations to notify. Supported values: + - `doc-sentinel`: Mentions @reem-sab + - `promptless`: Mentions @Promptless with the prompt + - `dosu`: Mentions @dosu with the prompt + - `claude`: Mentions @claude with the prompt + - `opencode`: Uses the `/opencode` command with the prompt + - `copilot`: Auto-assigns the issue to Copilot (instead of adding to the accordion) + + Integrations (except `copilot`) appear in a collapsible "Integrations" section in the issue body. Invalid integration names are warned and ignored. + +- `prompt`: Text passed to integrations, inserted where `$PROMPT` appears in integration mentions. You can also use `$PROMPT` in your custom `issue_body` template. Default: `"Investigate the causes of the failures reported in this Doc Detective test output and suggest fixes"`. + +### Example + +```yaml +- uses: doc-detective/github-action@v1 + with: + input: ./docs + create_issue_on_fail: true + integrations: claude,copilot + prompt: "Analyze these test failures and suggest documentation fixes" +``` From b8abf9c55b1a469975a9ebb848cba088adecd514 Mon Sep 17 00:00:00 2001 From: "promptless[bot]" <179508745+promptless[bot]@users.noreply.github.com> Date: Thu, 26 Feb 2026 22:17:21 +0000 Subject: [PATCH 2/2] Sync documentation updates --- fern/pages/contribute/repos/github-action.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/fern/pages/contribute/repos/github-action.md b/fern/pages/contribute/repos/github-action.md index c798525..5027027 100644 --- a/fern/pages/contribute/repos/github-action.md +++ b/fern/pages/contribute/repos/github-action.md @@ -35,7 +35,7 @@ Notify AI-powered integrations when issues are created to help investigate and f Integrations (except `copilot`) appear in a collapsible "Integrations" section in the issue body. Invalid integration names are warned and ignored. -- `prompt`: Text passed to integrations, inserted where `$PROMPT` appears in integration mentions. You can also use `$PROMPT` in your custom `issue_body` template. Default: `"Investigate the causes of the failures reported in this Doc Detective test output and suggest fixes"`. +- `prompt`: Text passed to integrations, inserted where `$PROMPT` appears in integration mentions. You can also use `$PROMPT` in your custom `issue_body` template. Default: `"Investigate potential causes of the failures reported in this Doc Detective test output and suggest fixes."`. ### Example