From eb26955fcf8c32fd4d397b298e141347d5c56a71 Mon Sep 17 00:00:00 2001 From: "promptless[bot]" Date: Tue, 31 Mar 2026 22:37:39 +0000 Subject: [PATCH] Clarify that context sources are read-only MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Add explicit language across all context source pages making clear that Promptless only reads from these services and never writes back to them. This addresses user confusion about whether Promptless updates Jira/Linear tickets or Confluence pages. Changes: - Added prominent Info callout on main Context Sources page stating context sources are "one-way"—Promptless reads but never writes - Updated intro paragraphs on Jira, Confluence, and Linear pages to explicitly state "read-only" access - Added clarifying sentences to Data Privacy sections on each page --- .../docs/docs/configuring-promptless/context-sources.mdx | 6 +++++- .../configuring-promptless/context-sources/confluence.mdx | 4 ++-- .../docs/configuring-promptless/context-sources/jira.mdx | 4 ++-- .../docs/configuring-promptless/context-sources/linear.mdx | 4 ++-- 4 files changed, 11 insertions(+), 7 deletions(-) diff --git a/src/content/docs/docs/configuring-promptless/context-sources.mdx b/src/content/docs/docs/configuring-promptless/context-sources.mdx index 41589efb..54240288 100644 --- a/src/content/docs/docs/configuring-promptless/context-sources.mdx +++ b/src/content/docs/docs/configuring-promptless/context-sources.mdx @@ -11,7 +11,11 @@ import Accordion from '@components/fern/Accordion.astro'; import AccordionGroup from '@components/fern/AccordionGroup.astro'; import Info from '@components/fern/Info.astro'; -Context sources are integrations that connect Promptless to your organization's existing tools and data. They provide additional context that helps Promptless create more accurate and comprehensive documentation suggestions. +Context sources are integrations that give Promptless **read-only** access to your organization's existing tools and data. They provide additional context that helps Promptless create more accurate and comprehensive documentation suggestions. + + +Context sources are **one-way**: Promptless reads information from these services to inform documentation updates, but never writes back to them. Your Jira tickets, Linear issues, and Confluence pages remain unchanged. + ## How Context Sources Work diff --git a/src/content/docs/docs/configuring-promptless/context-sources/confluence.mdx b/src/content/docs/docs/configuring-promptless/context-sources/confluence.mdx index 500c93f7..c073e446 100644 --- a/src/content/docs/docs/configuring-promptless/context-sources/confluence.mdx +++ b/src/content/docs/docs/configuring-promptless/context-sources/confluence.mdx @@ -7,7 +7,7 @@ sidebar: --- import Note from '@components/fern/Note.astro'; -Confluence integration provides access to your documentation spaces for documentation automation. When Confluence is configured as a context source, Promptless can search your Confluence spaces for relevant documentation when creating suggestions. +Confluence integration provides **read-only** access to your documentation spaces for documentation automation. When Confluence is configured as a context source, Promptless can search your Confluence spaces for relevant documentation when creating suggestions—but it never modifies your Confluence pages. ## How It Works as Context Source @@ -36,7 +36,7 @@ Promptless inherits the permissions of the Atlassian account used during OAuth c ## Data Privacy -Promptless queries Confluence data in real-time and does not store any of your Confluence data. All searches are performed on-demand when documentation updates are needed. +Promptless queries Confluence data in real-time and does not store any of your Confluence data. All searches are performed on-demand when documentation updates are needed. Promptless only reads from Confluence—it never creates, updates, or deletes pages. ## Setup Instructions diff --git a/src/content/docs/docs/configuring-promptless/context-sources/jira.mdx b/src/content/docs/docs/configuring-promptless/context-sources/jira.mdx index 22890e63..5a4254be 100644 --- a/src/content/docs/docs/configuring-promptless/context-sources/jira.mdx +++ b/src/content/docs/docs/configuring-promptless/context-sources/jira.mdx @@ -8,7 +8,7 @@ sidebar: import Frame from '@components/fern/Frame.astro'; import Note from '@components/fern/Note.astro'; -Jira integration provides access to your project management and issue tracking data for documentation automation. When Jira is configured as a context source, Promptless can search for related tickets to understand requirements and business context. +Jira integration provides **read-only** access to your project management and issue tracking data for documentation automation. When Jira is configured as a context source, Promptless can search for related tickets to understand requirements and business context—but it never modifies your Jira tickets. ## How It Works as Context Source @@ -44,7 +44,7 @@ Promptless inherits the permissions of the Jira account used during OAuth connec ## Data Privacy and Security -Promptless queries Jira data in real-time and does not store any of your Jira data. All searches are performed on-demand when documentation updates are needed. +Promptless queries Jira data in real-time and does not store any of your Jira data. All searches are performed on-demand when documentation updates are needed. Promptless only reads from Jira—it never creates, updates, or deletes tickets. For information about data processing and redaction capabilities, see the Atlassian integration page. diff --git a/src/content/docs/docs/configuring-promptless/context-sources/linear.mdx b/src/content/docs/docs/configuring-promptless/context-sources/linear.mdx index ac4070e8..c27e6a93 100644 --- a/src/content/docs/docs/configuring-promptless/context-sources/linear.mdx +++ b/src/content/docs/docs/configuring-promptless/context-sources/linear.mdx @@ -8,7 +8,7 @@ sidebar: import Frame from '@components/fern/Frame.astro'; import Note from '@components/fern/Note.astro'; -Linear integration provides secure access to your project management data for documentation automation. When Linear is configured as a context source, Promptless can search for related issues to understand the business context behind code changes. +Linear integration provides **read-only** access to your project management data for documentation automation. When Linear is configured as a context source, Promptless can search for related issues to understand the business context behind code changes—but it never modifies your Linear issues. ## How It Works as Context Source @@ -40,7 +40,7 @@ Promptless inherits the permissions of the Linear account used during OAuth conn ## Data Privacy -Promptless queries Linear data in real-time and does not store any of your Linear data. All searches are performed on-demand when documentation updates are needed. +Promptless queries Linear data in real-time and does not store any of your Linear data. All searches are performed on-demand when documentation updates are needed. Promptless only reads from Linear—it never creates, updates, or deletes issues. ## Setup Instructions