docs: Document automated quality assurance for documentation PRs

fern/docs/changelogs/2025-09.md

@@ -4,6 +4,32 @@ title: September 2025
 
 **Improvements:**
 
+* **Claude Sonnet 4.5 Model Upgrade:** Promptless now uses Claude Sonnet 4.5 for all organizations, delivering improved documentation quality and more accurate technical writing. Previously limited to pilot organizations, this upgrade ensures everyone benefits from the latest AI model capabilities.
+
 * **Enhanced Slack Context Understanding:** Promptless agents now analyze full Slack conversations instead of individual messages when creating documentation updates. When you share a Slack message URL, Promptless can now see the surrounding discussion to better understand context, decisions, and team conversations. This leads to more accurate and comprehensive documentation that captures the complete story behind your team's discussions.
 
+* **Enhanced GitHub PR Comment Context Awareness:** When you tag Promptless in individual GitHub PR comments, it now automatically reads all previous comments in the PR to understand the full context. This means you can use simple instructions like "Same here" or "Apply this change to the other section too" without having to repeat the full context. Previously, single comments couldn't reference other comments, requiring you to spell out instructions completely or use PR reviews for contextual feedback. This improvement makes it faster and easier to provide follow-on instructions directly in PR comment threads.
+
 * **GitBook Platform Support:** Promptless now supports GitBook as a first-class documentation hosting provider. Teams using GitBook can connect their repositories to automatically update their GitBook documentation when code changes are made. This expands Promptless support to include GitBook alongside existing platforms like Fern, Mintlify, and Docusaurus, making it easy for GitBook users to maintain up-to-date documentation through automated workflows.
+
+* **Improved Jira Context Integration:** Promptless now more reliably fetches Jira ticket information when issues are mentioned in pull requests or trigger events. When a Jira ticket ID appears in a PR description or comments, Promptless consistently retrieves the full ticket context including descriptions, comments, and related issues. This ensures documentation updates have complete context from your Jira workflow, leading to more accurate and comprehensive documentation that reflects the full scope of your work.
+
+* **Automated CI Check and Build Issue Resolution for Documentation PRs:** Promptless now automatically detects and fixes quality issues in documentation pull requests. When linters fail, Vale rules trigger warnings, or documentation hosting providers report broken links or build errors, Promptless automatically analyzes the issues and pushes fixes to the PR branch. This eliminates manual intervention for common quality problems and maintains documentation standards without interrupting your workflow. Quality issues are resolved seamlessly in the background, allowing teams to focus on content rather than troubleshooting technical problems.
+
+* **Smart Draft State Management for Documentation PRs:** Documentation PRs now open as drafts when the source code PR hasn't merged yet, then automatically switch to "Ready for Review" once the source PR merges. This means your team only reviews documentation changes after the underlying code is finalized.
+
+<Frame>
+  <img src="https://promptless-customer-doc-assets.s3.amazonaws.com/docs-images/org_2lvkgU9erOFxYhtEVVC0ymPrPdF/draft-pr-warning-dialog-1759347818.png" alt="Warning dialog showing that the documentation PR will be opened as a draft since the trigger PR is not merged yet" />
+</Frame>
+
+<Frame>
+  <img src="https://promptless-customer-doc-assets.s3.amazonaws.com/docs-images/org_2lvkgU9erOFxYhtEVVC0ymPrPdF/draft-pr-github-status-1759347818.png" alt="GitHub pull request showing draft status for Promptless documentation PR" />
+</Frame>
+
+* **Improved Dashboard Synchronization for Follow-on Suggestions:** The dashboard now immediately reflects changes when you make follow-on suggestions to documentation. Previously, there could be delays where the dashboard wouldn't show your latest follow-on edits right away. This improvement ensures that when you refine suggestions through follow-on instructions, the dashboard instantly updates to show your changes, providing better real-time visibility into your documentation workflow.
+
+* **PR Open Status Filter:** You can now filter for suggestions published as pull requests directly from the status dropdown. Previously, you had to manually type `is:pr_open` into the search bar. The "PR Open" option appears alongside "Ready," "Published," and "Rejected."
+
+<Frame>
+  <img src="https://promptless-customer-doc-assets.s3.amazonaws.com/docs-images/org_2lvkgU9erOFxYhtEVVC0ymPrPdF/pr-open-filter-dropdown-1759253451.png" alt="PR Open filter option in the suggestions dashboard status dropdown" />
+</Frame>

fern/docs/features/github-pr-comments.mdx

@@ -3,7 +3,7 @@ title: Interacting with Promptless PRs
 description: Learn how to provide follow-up instructions through GitHub PR comments and reviews after your documentation PR is opened
 ---
 
-After Promptless opens a docs PR, you can provide follow-on instructions directly through GitHub comments. 
+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.
 
 ## Two ways of providing feedback
 
@@ -13,9 +13,7 @@ Leave individual comments on specific lines or sections of the documentation PR
 
     Tag Promptless (@Promptless) in the comment (Note: It won't show up in auto-complete), write your instruction, and click "Add single comment" to submit your instruction to Promptless.
 
-<Note>
-  When using single comments, Promptless doesn't yet have the ability to look at other previous comments. So instructions like "Same here" wouldn't work. You can either spell out the instruction completely, or use the PR review comments below, where Promptless will have context on other comments in the same review.
-</Note>
+When you tag Promptless, it automatically reads all previous comments in the PR to understand the full context. This means that your instructions can be as simple as "Same here" or "Apply this change to the other section too," and Promptless will understand what you mean.
 
 ### 2. PR reviews
 

fern/docs/integrations/github.mdx

@@ -30,7 +30,7 @@ Promptless integrates with GitHub through our official GitHub App, providing sec
   <img src="../assets/integrations-complete.png" alt="Integrations Page" />
 </Frame>
 
-## Managing Repository Access After Installation
+## Adding More Repos After Installation
 
 After the initial installation, you may need to add new repositories or modify which repositories Promptless can access. You can manage this directly through your GitHub organization settings:
 
@@ -90,8 +90,27 @@ Once configured, your specified trigger directories will be visible in the proje
 
 When trigger directories are specified, only PRs that contain changes to those directories will be considered, and updates to other files will be ignored. 
 
+## Automated CI Check and Build Issue Resolution
+
+When Promptless opens a documentation PR, it automatically monitors the pull request for quality issues. If CI checks fail, linting tools report errors, Vale rules trigger warnings, or your documentation hosting provider detects broken links or build problems, Promptless will automatically analyze the issues and push fixes directly to the PR branch.
+
+This automated issue resolution works seamlessly with your existing GitHub workflow - there's no additional configuration needed. Quality problems get resolved in the background while you focus on content rather than troubleshooting technical issues.
+
 ## Authentication Model
 
 Promptless uses the official [GitHub App specification](https://docs.github.com/en/apps/creating-github-apps/about-creating-github-apps) to authenticate with GitHub. Promptless authenticates securely with JWTs generated by the GitHub App installation. 
 
-This ensures that Promptless has read and write access to the repositories that you select, and that either you or Promptless can revoke access at any time.
+This ensures that Promptless has read and write access to the repositories that you select, and that either you or Promptless can revoke access at any time.
+## Frequently Asked Questions
+
+### How do I add more repositories after installing the GitHub integration?
+
+Add additional repositories anytime by visiting your GitHub organization settings. In GitHub, head to `Settings -> Third-party Access -> GitHub Apps` then find the Promptless GitHub App and click "Configure." Add or remove repositories in the "Repository access" section, then click "Save." You'll be able to choose from the newly added repositories when creating or editing your Promptless projects.
+
+### Can I remove GitHub repository access from Promptless?
+
+You can remove access to specific repositories or even uninstall the integration entirely from the same "Configure" page in your GitHub organization settings. Click the `×` next to a repository name to remove it from the Promptless GitHub App, or click the `Uninstall` button at the bottom of the page to remove the app entirely.
+
+### How long does it take for repository changes to appear in Promptless?
+
+It may take a few minutes for repository updates in the GitHub App to be reflected in your Promptless dashboard. If you don't see newly added repositories right away when creating or editing projects, click the "refresh repos" icon in the integrations page.