GitHub Issues

Promptless monitors GitHub issues for documentation requests. When @Promptless is mentioned in an issue, the system analyzes the issue content and creates documentation suggestions.

How It Works

When @Promptless is mentioned in a GitHub issue:

1. Acknowledgment: Promptless adds a 👀 reaction to the issue to indicate processing has started
2. Analysis: Promptless reads the issue title, description, and comments to understand the documentation request
3. Relevance Assessment: Promptless determines if the issue content warrants documentation updates
4. Suggestion Creation: If relevant, Promptless creates documentation suggestions and posts results back to the issue

Note

If no doc collections are configured, Promptless posts a comment explaining that no matching configuration was found. This helps you understand why no documentation update was triggered.

When to Use GitHub Issues Triggers

GitHub Issues triggers are useful for:

• Documentation requests: Contributors or users can open issues requesting specific documentation improvements
• Open-source projects: Community members can tag Promptless in issues to generate documentation updates without needing access to other tools
• Tracking documentation gaps: Issues provide a natural place to discuss and track documentation needs before they’re addressed

Configuration

GitHub Issues triggers are a built-in trigger type that’s always active when the GitHub integration is connected, no YAML configuration required. When @Promptless is mentioned in an issue on any repository where the GitHub App is installed, Promptless processes the request.

Publishing behavior and notifications are controlled by your policies configuration.

GitHub Issues triggers require the GitHub App installation. See the GitHub Integration setup guide if you haven’t connected GitHub yet.

Setup Instructions

To connect GitHub to Promptless, see the GitHub Integration setup guide.