Expand FAQ with troubleshooting and configuration questions#496
Expand FAQ with troubleshooting and configuration questions#496promptless[bot] wants to merge 5 commits into
Conversation
Add new troubleshooting section covering common issues: - PR triggered but no suggestion appeared - Suggestions don't match docs style - How to undo a merged Promptless PR Add new configuration section with power-user questions: - Monorepo support - Excluding file types from triggers - Difference between triggers and context sources
promptless
Bot
requested review from
adit-chandra,
frances720,
mattlink and
prithvi2206
as code owners
![promptless[bot]](https://avatars.githubusercontent.com/in/979718?s=60&v=4){kind=small}
|
|
||
| ### My PR triggered but no suggestion appeared | ||
|
|
||
| Several configuration settings can prevent a PR from generating a suggestion: |
There was a problem hiding this comment.
Referenced directory-specific triggers, repository topics, draft PR behavior, and dot-file exclusions from the existing GitHub PRs trigger documentation at lines 77-93, 94-106, 134-136, and 139-142.
|
|
||
| ### Suggestions don't match my docs style | ||
|
|
||
| Promptless learns your writing style over time. To improve style matching: |
There was a problem hiding this comment.
Referenced Voice Match and AGENTS.md custom instructions from how-promptless-learns-your-docs.mdx at lines 26-36 and 42-82.
|
|
||
| 2. **Provide feedback**: Use the [Request Changes](/docs/how-to-use-promptless/providing-feedback#1-request-changes) button or inline comments to correct style issues. Check "Remember feedback for future suggestions" to save your preferences. | ||
|
|
||
| 3. **Create AGENTS.md**: Add an `AGENTS.md` file to your docs repository root with your style guidelines, terminology preferences, and formatting conventions. See [Custom Agent Instructions](/docs/configuring-promptless/doc-collections/how-promptless-learns-your-docs#custom-agent-instructions-with-agentsmd) for details. |
There was a problem hiding this comment.
Referenced Request Changes button and feedback options from providing-feedback.mdx at lines 14-27.
| For detailed information, see our [Data Handling documentation](/docs/security-and-privacy/data-handling-and-classification). | ||
|
|
||
| ## Configuration & Setup | ||
|
|
There was a problem hiding this comment.
Monorepo support information sourced from promptless-oss.mdx at lines 57-59 and 103-106 which mention specifying directories for monorepo setups.
|
|
||
| If you need more granular file type filtering, contact [help@gopromptless.ai](mailto:help@gopromptless.ai) to discuss your use case. | ||
|
|
||
| ### What's the difference between triggers and context sources? |
There was a problem hiding this comment.
Context sources explanation and comparison with triggers sourced from context-sources.mdx at lines 14-28 which explains their read-only nature and how they enrich suggestions.
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
Open this suggestion in Promptless to view citations and reasoning process
Adds a Troubleshooting section covering common issues (missing suggestions, style mismatch, reverting PRs) and a Configuration & Setup section with power-user questions about monorepos, file exclusions, and the difference between triggers and context sources. All answers follow the symptom → cause → solution pattern with links to detailed documentation.
Tip: Request one-off documentation tasks in the Dashboard under New Task 🚀