Context Sources
Context sources are integrations that connect Promptless to your organization’s existing tools and data. They often contain important information that can augment the trigger events.
How Context Sources Work
Think of context sources as Promptless’s way of understanding your team’s unique ecosystem. When triggered to create documentation updates, Promptless intelligently searches through your connected tools to gather the most relevant context. This creates documentation that feels like it was written by someone who truly understands your project.
Context sources are optional but highly recommended. They can improve the quality and relevance of Promptless’s documentation suggestions.
Available Context Sources
Access Linear issues, projects, and team workflows for project management context
Query Jira tickets and project data using JQL search capabilities
Search Slack conversations and threads for team discussions and decisions
Analyze code repositories, issues, and pull request discussions for technical context
Linear as a Context Source
When a GitHub PR mentions a new feature, Promptless searches Linear for related issues to understand additional project context. This ensures your documentation includes the “why” behind code changes, not just the “what.”
Jira as a Context Source
If a GitHub PR references a Jira ticket (like “PROJ-123”), Promptless automatically reads that Jira ticket for additional context. It also proactively search Jira using JQL for related issues and epics.
Slack as a Context Source
For example, when documenting a new API endpoint, Promptless can search Slack for previous discussions among team members to incorporate decisions, edge cases, or common questions.
Slack can serve as both a trigger source and context source.
GitHub as a Context Source
In addition to code diffs from trigger PRs, Promptless finds related GitHub issues and PR comments when you set GitHub as a context source.
Configuration and Setup
Context sources are configured at the project level:
Connect Integrations
Visit the Integrations page to connect your context sources using OAuth 2.0 authentication.
Configure Project Settings
In your project settings, select which context sources to enable and configure their search scope.
Data Privacy and Security
Promptless prioritizes your data privacy and security with context sources:
Real-time Queries Only
We do not store any of your organization’s data from context sources. Instead, our agents query the relevant APIs in real-time when documentation updates are needed, ensuring that we only access the information required for the specific documentation task at hand.
Secure Authentication
All context source integrations use:
- OAuth 2.0 authentication
- Encrypted data transmission (TLS 1.2+)
- Granular permission controls
- Token-based access that can be revoked at any time
Minimal Data Access
Promptless only accesses the specific information needed for documentation generation and does not retain or cache this data after processing.
Requesting Additional Context Sources
Need integration with other tools? Contact help@gopromptless.ai to request additional context sources. We’re continuously expanding our integration options to better serve your documentation needs.