From 43417debeac42af7fb9fac441e429e6ed1de318c Mon Sep 17 00:00:00 2001
From: "promptless[bot]" <179508745+promptless[bot]@users.noreply.github.com>
Date: Sat, 24 Jan 2026 00:08:19 +0000
Subject: [PATCH 1/2] Document commit trigger approaches and private channel
access
---
.../configuration/triggers/github-commits.md | 35 +++++++++++++++++++
fern/docs/integrations/slack.mdx | 12 ++++++-
2 files changed, 46 insertions(+), 1 deletion(-)
diff --git a/fern/docs/configuration/triggers/github-commits.md b/fern/docs/configuration/triggers/github-commits.md
index cd06868..f97e839 100644
--- a/fern/docs/configuration/triggers/github-commits.md
+++ b/fern/docs/configuration/triggers/github-commits.md
@@ -13,6 +13,26 @@ When a commit is pushed directly to a monitored branch:
3. **Relevance Assessment**: Promptless determines if the changes require documentation updates
4. **Suggestion Creation**: If relevant, Promptless creates documentation suggestions
+## Commit Triggers vs. Pull Request Triggers
+
+You can use GitHub commit triggers alongside PR triggers, or as a standalone approach.
+
+### Use commits alongside PR triggers
+
+If you configure both a GitHub PR project and a GitHub Commits project for the same repositories:
+
+- Promptless comments on PRs while they're open, providing early feedback on documentation needs
+- After the PR merges, the commit trigger updates suggestions with the final merged content
+- Useful when you want PR comments during review and updated suggestions after merge
+
+### Use commits only
+
+If you configure only a GitHub Commits project, without a corresponding PR project:
+
+- Promptless only runs after changes merge to your default branch
+- Reduces notification noise if PR triggers are too frequent
+- Since you won't get PR comments, configure a Slack notification channel to stay informed about new suggestions
+
## Configuration
Configure GitHub commit triggers in your [project settings](https://app.gopromptless.ai/projects):
@@ -27,6 +47,21 @@ Configure GitHub commit triggers in your [project settings](https://app.goprompt
+## Notification Channels
+
+Since commit triggers don't create PR comments, we recommend configuring a Slack notification channel. Promptless posts to this channel whenever it creates or updates suggestions based on commits.
+
+To configure a notification channel:
+
+1. Go to your [project settings](https://app.gopromptless.ai/projects)
+2. Click the pencil icon to edit your GitHub Commits project
+3. Add your preferred Slack channel at the bottom of the project settings
+4. Save your changes
+
+
+If you're using a private Slack channel, you'll need to add Promptless to that channel first. Tag `@Promptless` in the channel to prompt Slack to invite the app.
+
+
## Directory-Specific Commits
Similar to PR triggers, you can configure Promptless to only trigger on commits that affect specific directories. This is particularly useful for monitoring changelog directories or specific feature areas.
diff --git a/fern/docs/integrations/slack.mdx b/fern/docs/integrations/slack.mdx
index 30a72bf..de48547 100644
--- a/fern/docs/integrations/slack.mdx
+++ b/fern/docs/integrations/slack.mdx
@@ -43,6 +43,16 @@ Once connected, you can use Slack for:
## Privacy and Channel Access
-By default, Promptless only reads Slack content when you explicitly trigger it by tagging @Promptless or using the "Update Docs" message action. If you enable passive listening in your project settings, Promptless will monitor only the specific channels you select. Promptless cannot access private channels unless it has been specifically invited to those channels.
+By default, Promptless only reads Slack content when you explicitly trigger it by tagging @Promptless or using the "Update Docs" message action. If you enable passive listening in your project settings, Promptless will monitor only the specific channels you select.
+
+### Adding Promptless to Private Channels
+
+Promptless cannot access private channels unless it has been specifically invited. To add Promptless to a private channel, tag `@Promptless` in that channel—Slack will prompt you to invite the app.
+
+This is required if you want to:
+
+- Use a private channel as your notification channel for suggestions
+- Trigger Promptless from messages in a private channel
+- Enable passive listening on a private channel
For more details about using Slack with Promptless, see [Working with Slack](/docs/features/slack-interactions).
From ca3a9d496718a7fc071517049a8d93c7df7fa09f Mon Sep 17 00:00:00 2001
From: "promptless[bot]" <179508745+promptless[bot]@users.noreply.github.com>
Date: Tue, 27 Jan 2026 19:01:55 +0000
Subject: [PATCH 2/2] Sync documentation updates
---
fern/docs/configuration/triggers/github-commits.md | 10 +++++++---
1 file changed, 7 insertions(+), 3 deletions(-)
diff --git a/fern/docs/configuration/triggers/github-commits.md b/fern/docs/configuration/triggers/github-commits.md
index f97e839..80840fc 100644
--- a/fern/docs/configuration/triggers/github-commits.md
+++ b/fern/docs/configuration/triggers/github-commits.md
@@ -49,17 +49,21 @@ Configure GitHub commit triggers in your [project settings](https://app.goprompt
## Notification Channels
-Since commit triggers don't create PR comments, we recommend configuring a Slack notification channel. Promptless posts to this channel whenever it creates or updates suggestions based on commits.
+Since commit triggers don't create PR comments, configure a Slack notification channel to receive updates when Promptless creates or updates suggestions.
To configure a notification channel:
1. Go to your [project settings](https://app.gopromptless.ai/projects)
2. Click the pencil icon to edit your GitHub Commits project
-3. Add your preferred Slack channel at the bottom of the project settings
+3. Select your preferred Slack channel from the dropdown
4. Save your changes
-If you're using a private Slack channel, you'll need to add Promptless to that channel first. Tag `@Promptless` in the channel to prompt Slack to invite the app.
+If your channel doesn't appear in the dropdown, create it in Slack first, then refresh your Slack channels on the Integrations page.
+
+
+
+For private Slack channels, invite Promptless first by tagging `@Promptless` in the channel.
## Directory-Specific Commits