Skip to content
This repository was archived by the owner on Jul 4, 2025. It is now read-only.

docs: Document New Replay Recent PRs/MRs Feature for Project Setup #172

Open
wants to merge 1 commit into
base: main
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
20 changes: 20 additions & 0 deletions docs/changelogs/2025-06.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,20 @@
---
sidebar_position: 1
---

# June 2025

## New Features

### Replay Recent PRs/MRs on Project Setup

When setting up a new GitHub, Bitbucket, or GitLab project, you can now choose to have Promptless analyze recent pull requests or merge requests from the past 1-30 days. This "replay" feature helps you catch up on documentation for changes that occurred before Promptless was configured.

**How it works:**
- Enable the "Replay Pull Requests from the last N days" option when creating a new project
- Choose between 1-30 days to look back for recent PRs/MRs
- Promptless automatically analyzes these recent changes and suggests documentation updates as needed
- Works with all supported repository platforms (GitHub, Bitbucket, GitLab)
- Respects your project's directory-specific trigger settings

This feature is particularly useful for teams adding Promptless to existing projects with active development.
4 changes: 4 additions & 0 deletions docs/core-concepts/triggers.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,6 +14,8 @@ When configured, Promptless automatically runs whenever a new pull request is op

During the review process, if you need additional changes or have specific requests for the documentation updates, you can use the follow-on request feature. This allows you to provide additional instructions or feedback to Promptless, which will then process your request and suggest updated changes based on your input.

When setting up a new GitHub project, you can optionally enable the replay feature to analyze recent pull requests from the past 1-30 days. This helps catch up on documentation for changes that occurred before Promptless was configured.

### Bitbucket Pull Requests

Similar to GitHub, Promptless can be triggered by pull requests in Bitbucket repositories. When a new pull request is opened in your specified Bitbucket repositories, Promptless analyzes the changes and suggests documentation updates if needed. You can configure specific directories to monitor for changes, allowing you to focus documentation efforts on the most relevant parts of your codebase.
Expand All @@ -22,6 +24,8 @@ The workflow for Bitbucket triggers follows the same pattern as GitHub triggers,

Note that Promptless automatically skips draft pull requests in Bitbucket. Documentation updates will only be triggered when the pull request is marked as ready for review.

When setting up a new Bitbucket project, you can optionally enable the replay feature to analyze recent pull requests from the past 1-30 days. This helps catch up on documentation for changes that occurred before Promptless was configured.

### Slack Integration

When configured, Promptless can be triggered from Slack channels to find documentation updates that may be warranted from a thread. Primarily, this is used in Slack Connect support channels with customers -- where in a thread, a customer asks a question about your product, your team has answered it, and when Promptless is triggered, it suggests documentation updates based on the content of the thread. This is particularly useful if you notice a common question that you think should be answered in the docs.
Expand Down
11 changes: 11 additions & 0 deletions docs/getting-started.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -35,6 +35,17 @@ For GitHub or Bitbucket-based projects, you can enable auto-publish to automatic

When reviewing documentation updates in the dashboard, you can use the follow-on request feature to ask Promptless for additional changes or refinements to its initial suggestions. This is particularly useful when you want to provide specific feedback or request modifications to the proposed documentation updates.

### Replay Recent PRs/MRs

When setting up a new GitHub, Bitbucket, or GitLab project, you can choose to have Promptless analyze recent pull requests or merge requests from the past 1-30 days. This "replay" feature is particularly useful when you're setting up Promptless for an existing project and want to catch up on documentation for recent changes that occurred before Promptless was configured.

To enable this feature:
1. Check the "Replay Pull Requests from the last" checkbox when creating your project
2. Specify the number of days (1-30) to look back for recent PRs/MRs
3. Promptless will automatically analyze these recent changes and suggest documentation updates as needed

This feature works for all supported repository platforms (GitHub, Bitbucket, and GitLab) and respects your project's directory-specific trigger settings if configured.

A new project for a Github PR trigger might look like this:

<img src="https://promptless-customer-doc-assets.s3.amazonaws.com/docs-images/org_2lvkgU9erOFxYhtEVVC0ymPrPdF/80863009-2671-4d86-91d6-95633becce22-new-project-modal-updated.png" alt="Create New Project modal" style={{width:"700px", display: "block", margin: "0 auto", marginBottom: "20px", boxShadow: "0 4px 8px rgba(0, 0, 0, 0.1)"}} />
Expand Down
11 changes: 11 additions & 0 deletions docs/integrations/bitbucket.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -55,6 +55,17 @@ To set up directory-specific triggers:
2. Under **Advanced Options**, enable **Directory-Specific Triggers**
3. Enter the directories you want to monitor, separated by commas (e.g., `src/api, docs/reference`)

### Replay Recent Pull Requests

When setting up a new Bitbucket project, you can optionally enable the replay feature to analyze recent pull requests from the past 1-30 days. This is particularly useful when you're adding Promptless to an existing project and want to catch up on documentation for changes that occurred before Promptless was configured.

To enable this feature:
1. Check the "Replay Pull Requests from the last" checkbox when creating your project
2. Specify the number of days (1-30) to look back for recent PRs
3. Promptless will automatically analyze these recent changes and suggest documentation updates as needed

This feature respects your project's directory-specific trigger settings if configured, so it will only analyze PRs that contain changes to your specified directories.

## Authentication Model

The Bitbucket integration uses a username and app password authentication model:
Expand Down
11 changes: 11 additions & 0 deletions docs/integrations/github.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -44,6 +44,17 @@ For example, in the below example, Promptless is only able to read the `promptle

<img src="/img/Github-project.png" alt="Project Setup" style={{width:"800px", display: "block", margin: "0 auto", boxShadow: "0 4px 8px rgba(0, 0, 0, 0.1)"}} />

### Replay Recent Pull Requests

When setting up a new GitHub project, you can optionally enable the replay feature to analyze recent pull requests from the past 1-30 days. This is particularly useful when you're adding Promptless to an existing project and want to catch up on documentation for changes that occurred before Promptless was configured.

To enable this feature:
1. Check the "Replay Pull Requests from the last" checkbox when creating your project
2. Specify the number of days (1-30) to look back for recent PRs
3. Promptless will automatically analyze these recent changes and suggest documentation updates as needed

This feature respects your project's directory-specific trigger settings if configured, so it will only analyze PRs that contain changes to your specified directories.

## Trigger Events in Pull Request Descriptions

When Promptless creates a pull request for documentation updates, it automatically includes a list of the trigger events that led to those changes in the PR description. This provides valuable context for reviewers and creates clear traceability between documentation updates and their originating events.
Expand Down