From 7a0776ec3f1151bda9a58d86bd85249c7298b1be Mon Sep 17 00:00:00 2001 From: "promptless[bot]" Date: Tue, 31 Mar 2026 23:28:44 +0000 Subject: [PATCH 1/3] Add first-approval trigger mode documentation for GitHub PRs Documents the new trigger mode option that fires on first PR approval instead of on PR open. Includes when to use each mode and configuration instructions. --- .../triggers/git-hub-p-rs.mdx | 29 +++++++++++++++---- 1 file changed, 23 insertions(+), 6 deletions(-) diff --git a/src/content/docs/docs/configuring-promptless/triggers/git-hub-p-rs.mdx b/src/content/docs/docs/configuring-promptless/triggers/git-hub-p-rs.mdx index ca91f2fc..4f3df9df 100644 --- a/src/content/docs/docs/configuring-promptless/triggers/git-hub-p-rs.mdx +++ b/src/content/docs/docs/configuring-promptless/triggers/git-hub-p-rs.mdx @@ -10,11 +10,27 @@ import Info from '@components/fern/Info.astro'; import Note from '@components/fern/Note.astro'; import Warning from '@components/fern/Warning.astro'; -Promptless automatically monitors your GitHub repositories for new pull requests. When a PR is opened, the system analyzes the changes to determine if documentation updates are needed. +Promptless monitors your GitHub repositories for pull requests. You can choose when documentation updates trigger: when a PR is opened or when it receives its first approval. + +## Trigger Modes + +GitHub PR triggers support two modes: + +### Opened (Default) + +Triggers when a pull request is opened. This works well for teams that want documentation suggestions ready alongside code changes, giving reviewers time to evaluate both. + +### First Approval + +Triggers when a pull request receives its first approval from a reviewer. Use this mode when you want documentation updates to start only after code has been reviewed, so Promptless analyzes final changes rather than work in progress. + + +The first-approval mode only triggers once per PR—on the first approval. Subsequent approvals or re-approvals after requested changes do not trigger additional documentation updates. + ## How It Works -When a pull request is opened in your monitored repositories: +When a pull request event occurs in your monitored repositories (either opened or first approval, depending on your configuration): 1. **Automatic Detection**: Promptless receives notification of the new PR 2. **Analysis**: The system processes the code diff, PR title, and PR description to understand the context @@ -22,7 +38,7 @@ When a pull request is opened in your monitored repositories: 4. **Suggestion Creation**: If relevant, Promptless creates documentation suggestions -Information from PRs is processed in real-time and not stored by Promptless. The analysis happens only when the PR is created or updated. +Information from PRs is processed in real-time and not stored by Promptless. The analysis happens only when the configured trigger event occurs. ## Configuration @@ -30,9 +46,10 @@ Information from PRs is processed in real-time and not stored by Promptless. The Configure GitHub PR triggers in your [project settings](https://app.gopromptless.ai/projects): 1. Select GitHub as your trigger source -2. Choose which repositories to monitor -3. Optionally configure directory-specific triggers (see below) -4. Set auto-publish preferences +2. Choose the trigger mode: **Opened** (default) or **First approval** +3. Choose which repositories to monitor +4. Optionally configure directory-specific triggers (see below) +5. Set auto-publish preferences GitHub project configuration showing trigger repository selection From fa73cc945f69fa2cd12650920a51eac43f98640d Mon Sep 17 00:00:00 2001 From: "promptless[bot]" Date: Wed, 1 Apr 2026 02:03:18 +0000 Subject: [PATCH 2/3] Add screenshot and replay limitation for PR trigger modes - Add screenshot showing the PR trigger timing dropdown with both options - Update configuration step to use exact UI labels ("When PR opens", "After first approval") - Add note that replay is not available for first-approval triggers - Add caption to Frame component per style guide --- .../configuring-promptless/triggers/git-hub-p-rs.mdx | 10 +++++++--- 1 file changed, 7 insertions(+), 3 deletions(-) diff --git a/src/content/docs/docs/configuring-promptless/triggers/git-hub-p-rs.mdx b/src/content/docs/docs/configuring-promptless/triggers/git-hub-p-rs.mdx index 4f3df9df..b6c99844 100644 --- a/src/content/docs/docs/configuring-promptless/triggers/git-hub-p-rs.mdx +++ b/src/content/docs/docs/configuring-promptless/triggers/git-hub-p-rs.mdx @@ -28,6 +28,10 @@ Triggers when a pull request receives its first approval from a reviewer. Use th The first-approval mode only triggers once per PR—on the first approval. Subsequent approvals or re-approvals after requested changes do not trigger additional documentation updates. + +Replay is not available for first-approval triggers. To re-run documentation analysis on a PR, use the Slack or web interface to manually request an update. + + ## How It Works When a pull request event occurs in your monitored repositories (either opened or first approval, depending on your configuration): @@ -46,13 +50,13 @@ Information from PRs is processed in real-time and not stored by Promptless. The Configure GitHub PR triggers in your [project settings](https://app.gopromptless.ai/projects): 1. Select GitHub as your trigger source -2. Choose the trigger mode: **Opened** (default) or **First approval** +2. Choose the trigger mode: **When PR opens** (default) or **After first approval** 3. Choose which repositories to monitor 4. Optionally configure directory-specific triggers (see below) 5. Set auto-publish preferences - - GitHub project configuration showing trigger repository selection + + Edit Project modal showing PR trigger timing dropdown with 'When PR opens' and 'After first approval' options ## Directory-Specific Triggers From 54cc57c1719dffaa15801944cecf17090b5615e3 Mon Sep 17 00:00:00 2001 From: "promptless[bot]" <179508745+promptless[bot]@users.noreply.github.com> Date: Wed, 1 Apr 2026 15:24:13 +0000 Subject: [PATCH 3/3] Update from prithvi@gopromptless.ai --- .../docs/docs/configuring-promptless/triggers/git-hub-p-rs.mdx | 3 --- 1 file changed, 3 deletions(-) diff --git a/src/content/docs/docs/configuring-promptless/triggers/git-hub-p-rs.mdx b/src/content/docs/docs/configuring-promptless/triggers/git-hub-p-rs.mdx index b6c99844..2df37d66 100644 --- a/src/content/docs/docs/configuring-promptless/triggers/git-hub-p-rs.mdx +++ b/src/content/docs/docs/configuring-promptless/triggers/git-hub-p-rs.mdx @@ -28,9 +28,6 @@ Triggers when a pull request receives its first approval from a reviewer. Use th The first-approval mode only triggers once per PR—on the first approval. Subsequent approvals or re-approvals after requested changes do not trigger additional documentation updates. - -Replay is not available for first-approval triggers. To re-run documentation analysis on a PR, use the Slack or web interface to manually request an update. - ## How It Works