Skip to content

docs: Fix all broken internal links across documentation#239

Open
promptless[bot] wants to merge 7 commits intomainfrom
promptless/fix-all-broken-links
Open

docs: Fix all broken internal links across documentation#239
promptless[bot] wants to merge 7 commits intomainfrom
promptless/fix-all-broken-links

Conversation

@promptless
Copy link
Contributor

@promptless promptless bot commented Feb 12, 2026

Open this suggestion in Promptless to view citations and reasoning process

Fixes 44 broken links across 24 documentation files. Updates outdated /docs/configuration/ paths to /docs/configuring-promptless/, fixes missing /docs/ prefixes on Card hrefs, corrects wrong integration page slugs, updates the privacy policy URL from www.gopromptless.ai to promptless.ai, fixes the #ip-whitelisting anchor, removes a non-existent Slack context source reference, and fixes the garbled doc-c-m-ss link in the pilot guide.

Trigger Events

Web UI: Please review this slack message and make sure that all of t...

Agent Response

I reviewed the Slack thread and the broken links CSV report, then verified every link against the current docs. Here's what I found and fixed:

The previous broken links suggestion was never merged — all 44 broken links from the original report still existed in the current documentation.

I created a new suggestion that fixes all broken links across 24 files. Here's a summary of the issue categories:

Issue Count Example
Wrong section path (/docs/configuration//docs/configuring-promptless/) 28 links Card hrefs, inline links across integration and config pages
Missing /docs/ prefix on Card hrefs 4 links "How to use Promptless" overview page cards
Wrong integration page slugs (/zendesk/zendesk-integration) 4 links Cross-references from config sub-pages
Wrong account management path 3 links FAQ, Atlassian, and Jira pages
Wrong feature section paths 2 links FAQ and Slack integration pages
Privacy policy URL (www.gopromptless.aipromptless.ai) 1 link Privacy policy page
Broken anchor (#ip-whitelisting#step-6-ip-whitelisting) 1 link GitHub Enterprise page
Non-existent page reference (Slack context source) 1 link Removed — Slack is a trigger, not a context source
Garbled slug (doc-c-m-ss) 1 link Pilot guide page

Two items from the original report that remain external issues:

  • accounts.gopromptless.ai returning 403 — expected behavior for a login page (not a docs issue)

Tip: Set up a GitHub Issues trigger in Projects to enable @Promptless mentions in issues 🐙


<CardGroup cols={2}>
<Card title="GitHub PRs" icon="fa-brands fa-github" href="/docs/configuration/triggers/github-prs">
<Card title="GitHub PRs" icon="fa-brands fa-github" href="/docs/configuring-promptless/triggers/github-prs">
Copy link
Contributor Author

Choose a reason for hiding this comment

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

Citation: Broken links report (CSV attachment) identified 44 broken internal links. Card hrefs like /docs/configuration/triggers/github-prs needed to be updated to /docs/configuring-promptless/triggers/github-prs to match Fern's URL generation from the docs.yml section name "Configuring Promptless".
View source


For the complete, current version of our privacy policy, please visit:
[Promptless Privacy Policy](https://www.gopromptless.ai/privacy)
[Promptless Privacy Policy](https://promptless.ai/privacy)
Copy link
Contributor Author

Choose a reason for hiding this comment

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

Citation: Prithvi confirmed in the Slack thread that the correct privacy policy URL is promptless.ai/privacy (previously www.gopromptless.ai/privacy which returned 404).
View source

@github-actions
Copy link

@github-actions
Copy link

@github-actions
Copy link

@promptless
Copy link
Contributor Author

promptless bot commented Feb 12, 2026

I've added new changes to address this change request from the dashboard in commit cda92b5

@promptless
Copy link
Contributor Author

promptless bot commented Feb 12, 2026

🔧 I noticed that some CI checks failed for this PR. I'm investigating whether the failures are caused by this suggestion. If they're unrelated or pre-existing, I'll leave this suggestion unchanged and create a separate suggestion if a standalone docs fix is needed.

@github-actions
Copy link

@promptless
Copy link
Contributor Author

promptless bot commented Feb 12, 2026

I've added new changes to address this CI failure in commit 3b67e14

@promptless
Copy link
Contributor Author

promptless bot commented Feb 12, 2026

🔧 I noticed that some CI checks failed for this PR. I'm investigating whether the failures are caused by this suggestion. If they're unrelated or pre-existing, I'll leave this suggestion unchanged and create a separate suggestion if a standalone docs fix is needed.

@github-actions
Copy link

@promptless
Copy link
Contributor Author

promptless bot commented Feb 12, 2026

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

@promptless
Copy link
Contributor Author

promptless bot commented Feb 12, 2026

🔧 I noticed that some CI checks failed for this PR. I'm investigating whether the failures are caused by this suggestion. If they're unrelated or pre-existing, I'll leave this suggestion unchanged and create a separate suggestion if a standalone docs fix is needed.

@github-actions
Copy link

@promptless
Copy link
Contributor Author

promptless bot commented Feb 12, 2026

🔧 I noticed that some CI checks failed for this PR. I'm investigating whether the failures are caused by this suggestion. If they're unrelated or pre-existing, I'll leave this suggestion unchanged and create a separate suggestion if a standalone docs fix is needed.

@github-actions
Copy link

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.

0 participants