Skip to content

📖 docs: Make Conversation Pull Requests a User Guide With Screenshots - #809

Open
berry-13 wants to merge 2 commits into
mainfrom
docs/pull-requests-remove-pending
Open

berry-13 wants to merge 2 commits into
mainfrom
docs/pull-requests-remove-pending

Conversation

@berry-13

@berry-13 berry-13 commented Oct 8, 2026

Copy link
Copy Markdown
Collaborator

Summary

Follow-up to #808, which already merged. The Conversation Pull Requests page was written from the implementation spec, so it read like a reference. This makes it a user guide.

  • Removes everything tied to the unreleased default-on change (🔌 feat: Enable Pull Requests by Default With a Token Fallback LibreChat#16876): the Pending callouts, the token environment fallback and allowAllRepositories. The pages now describe only enabled: true, a ${NAME} token reference and allowedRepositories. These can come back in a later PR once #16876 merges.
  • Removes the API reference, startup-config fields, rolling-upgrade and security-model sections from the feature page.
  • Rewrites the page around what users see, with the screenshots from LibreChat PRs #16794 and #16815 (light and dark): header chip states, the card, sidebar rows, and the small-screen menu and dialog. The images are copied into public/images/pull-requests and use the existing ThemeImage component.
  • Splits setup into four short steps and trims troubleshooting to user-facing symptoms.

Still open and left as TODO comments in the page: where an admin sets the repository for a workspace environment, the first release version, and the changelog entry.

Testing

  • pnpm typecheck and pnpm lint exit 0, and the page compiles with @mdx-js/mdx.
  • All 14 image paths in the page exist under public/images.
  • Not verified: pnpm build, and how the page and images look in a browser.

@vercel

vercel Bot commented Oct 8, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
librechat-ai Ready Ready Preview Oct 8, 2026 9:20am UTC

Request Review

@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Oct 8, 2026 •

Copy link
Copy Markdown

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review ✅ Completed 2026-10-08T09:17:33.831018Z fb1461c PR opened
🔒 Security Review ✅ Completed 2026-10-08T09:15:05.574260Z fb1461c PR opened
ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: fb1461cd85

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment on lines +89 to +90
light="/images/pull-requests/mob-menu-light.png"
dark="/images/pull-requests/mob-menu-dark.png"

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Replace the obscured mobile-menu screenshots

Both mob-menu-light.png and mob-menu-dark.png show the menu and its PR #1234 entry at extremely low opacity, making the entry nearly indistinguishable from the background in either theme. Since this image is meant to show users where the small-screen pull-request control is located, recapture it without the dimming/transition overlay so the target menu item is readable.

Useful? React with 👍 / 👎.

- The pull request number, with lines added in green and lines removed in red.
- A link that opens the pull request on GitHub.
- The pull request title.
- A **State** badge: Open, Draft, Merged or Closed.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Include the conflict state in the badge list

The newly added conflict screenshot directly below this section shows the card badge as State: Conflicts, but this list says the only possible state badges are Open, Draft, Merged, or Closed. This makes the guide contradict its own example for a normal merge-conflict scenario; include Conflicts and clarify that it is displayed instead of Open when the pull request cannot merge.

Useful? React with 👍 / 👎.

### The status icon and dot

**Older versions:** `token` is required when the feature is enabled, and must be a `${NAME}` reference such as `"${GITHUB_PULL_REQUEST_TOKEN}"`. There is no environment variable fallback.
The icon color tells you if the pull request can merge. The dot next to it shows the state of the checks.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Describe where the header status dot actually appears

When the chat agent has an avatar—as in every new header screenshot—the checks dot is overlaid on that avatar rather than placed next to the pull-request icon; the icon carries the dot only when no avatar is available. Saying the dot is next to the icon directs users to the wrong part of the chip in the common avatar case, so document this conditional placement.

Useful? React with 👍 / 👎.

@github-actions

github-actions Bot commented Oct 8, 2026

Copy link
Copy Markdown
Contributor

📦 Next.js Bundle Analysis for librechat.ai

This analysis was generated by the Next.js Bundle Analysis action. 🤖

This PR introduced no changes to the JavaScript bundle! 🙌

This branch was successfully deployed

1 active deployment
Preview — fb1461cd Deployed Oct 8, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant