Skip to content

Conversation

@promptless
Copy link
Contributor

@promptless promptless bot commented Dec 16, 2025

Major reorganization to improve clarity of GitHub integration and configuration concepts, as requested by Prithvi.

Key Changes:

  1. Core Concepts is now a standalone page under "Getting Started" (no subpages)

    • Provides high-level conceptual overview
    • Links to detailed configuration pages
  2. New "Configuring Promptless" section with three main areas:

    • Triggers: Parent page + child pages for GitHub PRs, GitHub Commits, Slack, MS Teams, and Zendesk
    • Context Sources: Parent page + child pages for Linear, Jira, Slack, and GitHub
    • Doc Collections: Parent page + child pages for GitHub Repos (Docs as Code), Zendesk, Intercom, and Webflow
  3. Integration pages pared down to setup/installation only:

    • Trigger-specific content moved to Triggers section
    • Context source details moved to Context Sources section
    • Publishing platform details moved to Doc Collections section
    • Each integration page now focuses on connection/authentication

This reorganization makes it much clearer how each integration (especially GitHub) can be used for different purposes and consolidates related configuration information together.

Trigger Events

Open this suggestion in the Promptless dashboard


Help us improve Promptless — If this suggestion missed the mark, please share quick feedback.

If you want Promptless to make further changes on this PR, feel free to leave a comment tagging Promptless (It won't show up in the user drop down but Promptless will get it!)

@promptless
Copy link
Contributor Author

promptless bot commented Dec 16, 2025

🔧 I noticed that some CI checks failed for this PR. I'm investigating the failures and will work on fixing them.

@promptless
Copy link
Contributor Author

promptless bot commented Dec 16, 2025

I've added new changes to address this CI failure in commit 5e88509

@github-actions
Copy link

@github-actions
Copy link

@prithvi2206
Copy link
Contributor

@Promptless i want the titles on the left nav for "Triggers" to always be descriptive about the specific events that promptless is listening to. so for example, instead of "Slack", it should be something like "Slack Messages".

image

@prithvi2206
Copy link
Contributor

@Promptless can you also add a page for Document360 as a Doc Collection?

@promptless
Copy link
Contributor Author

promptless bot commented Dec 20, 2025

I've added new changes to address this PR comment in commit a67d291

@github-actions
Copy link

@prithvi2206
Copy link
Contributor

image

it's weird for the context sources to be next to the triggers in here. let's have context sources be to the right of the agent, with the arrow going from the agent to the context sources, since that's a pull data flow

@prithvi2206
Copy link
Contributor

image it's weird for the context sources to be next to the triggers in here. let's have context sources be to the right of the agent, with the arrow going from the agent to the context sources, since that's a pull data flow

@Promptless forgot to tag you

@prithvi2206
Copy link
Contributor

@Promptless we don't have a slack context source or a github context source :(

can you delete those files plz

@promptless
Copy link
Contributor Author

promptless bot commented Dec 20, 2025

I've added new changes to address this PR comment in commit 21381d5

@github-actions
Copy link

@promptless
Copy link
Contributor Author

promptless bot commented Dec 20, 2025

I've added new changes to address this PR comment in commit 70940ed

@github-actions
Copy link

@promptless
Copy link
Contributor Author

promptless bot commented Dec 20, 2025

Promptless escalated the following message to you. If you respond, please remember to tag Promptless:

All of your feedback has been addressed! Here's what was updated:

Trigger navigation titles are now descriptive about the specific events:

  • "Slack Messages" instead of just "Slack"
  • "Microsoft Teams Messages" instead of just "Microsoft Teams"
  • "Zendesk Tickets (Beta)" instead of just "Zendesk"
  • "GitHub PRs" and "GitHub Commits" remain clear

Document360 has been added as a Doc Collection with its own dedicated page

Diagram layout fixed - Context Sources are now positioned to the right of the Promptless AI Agent (showing the pull data flow), with a dotted arrow from the agent to context sources

Removed non-existent context sources - Slack and GitHub context source pages have been deleted since we don't actually have those. Only Linear and Jira remain as context sources.

The changes are live in the latest preview: https://promptless-preview-bd22a3bd-e3c0-4d68-b950-2371bee3d0a6.docs.buildwithfern.com

Let me know if you'd like any additional adjustments!

@promptless
Copy link
Contributor Author

promptless bot commented Dec 20, 2025

I've processed your request, but no documentation changes were needed.

@frances720 frances720 merged commit 450b8c2 into main Dec 22, 2025
2 checks passed
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.

3 participants