Skip to content

docs: improve SSL certificate troubleshooting guidance#11354

Open
fahe1em1 wants to merge 1 commit intocontinuedev:mainfrom
fahe1em1:codex/continue-9175-ssl-docs
Open

docs: improve SSL certificate troubleshooting guidance#11354
fahe1em1 wants to merge 1 commit intocontinuedev:mainfrom
fahe1em1:codex/continue-9175-ssl-docs

Conversation

@fahe1em1
Copy link

@fahe1em1 fahe1em1 commented Mar 12, 2026

Summary

This improves the SSL/TLS troubleshooting path by making the common certificate errors searchable and actionable. It adds exact error strings to the FAQ, a dedicated troubleshooting section with curl and openssl diagnosis steps plus a caBundlePath example, and a cross-link from the self-hosting guide. It also softens the Windows guidance so win-ca is not presented as the only fix and points readers back to caBundlePath as the reliable option.

Testing

  • npx --yes prettier --check docs/faqs.mdx docs/troubleshooting.mdx docs/guides/how-to-self-host-a-model.mdx
  • npx mintlify broken-links

Why this is small and safe

This is a docs-only change scoped to three existing pages. It does not change runtime behavior or config parsing, but it should make a recurring support issue much easier to diagnose and fix.

Fixes #9175


Summary by cubic

Improves SSL/TLS troubleshooting docs with exact error strings, step-by-step curl/openssl diagnosis, and a clear requestOptions.caBundlePath example, plus a cross-link from self-hosting. Updates Windows guidance to note win-ca as optional and point to caBundlePath as the reliable fix. Fixes #9175.

Written for commit 0c3792e. Summary will update on new commits.

@fahe1em1 fahe1em1 requested a review from a team as a code owner March 12, 2026 19:30
@fahe1em1 fahe1em1 requested review from sestinj and removed request for a team March 12, 2026 19:30
@dosubot dosubot bot added the size:M This PR changes 30-99 lines, ignoring generated files. label Mar 12, 2026
@github-actions
Copy link
Contributor

github-actions bot commented Mar 12, 2026

All contributors have signed the CLA ✍️ ✅
Posted by the CLA Assistant Lite bot.

@fahe1em1
Copy link
Author

I have read the CLA Document and I hereby sign the CLA

Copy link
Contributor

@cubic-dev-ai cubic-dev-ai bot left a comment

Choose a reason for hiding this comment

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

No issues found across 3 files

Copy link
Collaborator

@RomneyDa RomneyDa left a comment

Choose a reason for hiding this comment

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

@fahe1em1 thanks for the contribution, this is great

@github-project-automation github-project-automation bot moved this from Todo to In Progress in Issues and PRs Mar 13, 2026
@dosubot dosubot bot added the lgtm This PR has been approved by a maintainer label Mar 13, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

lgtm This PR has been approved by a maintainer size:M This PR changes 30-99 lines, ignoring generated files.

Projects

Status: In Progress

Development

Successfully merging this pull request may close these issues.

Improve SSL certificate error documentation and troubleshooting

2 participants