Skip to content

docs: Clarify that @Promptless mentions only work on docs PRs#316

Open
promptless[bot] wants to merge 2 commits intomainfrom
promptless/clarify-promptless-mentions-scope
Open

docs: Clarify that @Promptless mentions only work on docs PRs#316
promptless[bot] wants to merge 2 commits intomainfrom
promptless/clarify-promptless-mentions-scope

Conversation

@promptless
Copy link
Contributor

@promptless promptless bot commented Mar 23, 2026

Open this suggestion in Promptless to view citations and reasoning process

Adds Info callouts to the "Providing Feedback" and "Interacting with Promptless PRs" pages clarifying that tagging @Promptless in GitHub PR comments only works on documentation PRs that Promptless has opened, not on source code PRs.

What's new:

  • Added Info callout to "Providing Feedback" page (section "5. GitHub PR Comments") explaining the scope limitation
  • Added Info callout to "Interacting with Promptless PRs" page explaining the scope limitation

Why this matters:
PR #2178 removed in-product tips about tagging @Promptless from source code PRs because users were confused when this didn't work. The documentation should also clarify this limitation so users understand that @Promptless mentions only work on docs PRs opened by Promptless, not on their source code PRs.

Related trigger: https://github.com/Promptless/promptless/pull/2178


Leave comments directly in the GitHub PR interface to provide feedback. Tag @Promptless in any line comment to request changes.

<Info>
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

PR #2178 excludes "tag @Promptless" tips from source code PRs because tagging @Promptless only works on docs PRs opened by Promptless, not on source code PRs.

Source: https://github.com/Promptless/promptless/pull/2178

After Promptless opens a docs PR, you can provide follow-on instructions directly through GitHub comments. Promptless automatically handles quality issues (like linter failures, Vale warnings, or broken links) that arise in documentation PRs, so manual feedback can focus on content improvements rather than technical fixes.

<Info>
Tagging @promptless in PR comments only works on documentation PRs that Promptless has opened. It does not work on source code PRs in your application repositories.
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

PR #2178 excludes "tag @Promptless" tips from source code PRs because tagging @Promptless only works on docs PRs opened by Promptless, not on source code PRs.

Source: https://github.com/Promptless/promptless/pull/2178

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@Promptless can you clarify that this is a temporary limitation that we are rebuilding a system to handle this better, and will soon be available everywhere on github, including issues, PRs opened on arbitrary repos by arbitrary authors

@vercel
Copy link

vercel bot commented Mar 23, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
promptless-docs Ready Ready Preview, Comment Mar 26, 2026 11:33pm

Request Review

Updated Info callouts in both files to explain that:
- This is a temporary limitation while rebuilding the system
- Soon @Promptless will work everywhere on GitHub including issues
  and PRs on any repository
@promptless
Copy link
Contributor Author

promptless bot commented Mar 26, 2026

Thanks for the feedback @InlinePizza! I've updated the callouts in both files to clarify that this is a temporary limitation while we rebuild the system, and that @Promptless mentions will soon work everywhere on GitHub, including issues and PRs on any repository.

Updated callout text:

Currently, tagging @Promptless in comments only works on documentation PRs that Promptless has opened—it doesn't work on source code PRs or issues. This is a temporary limitation while we rebuild the system to handle more contexts. Soon, @Promptless mentions will work everywhere on GitHub, including issues and PRs on any repository.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant