-
Notifications
You must be signed in to change notification settings - Fork 883
docs: add faqs from sharkymark #11168
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Conversation
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
A few suggestions on linking docs at some places and making very long answers brief.
docs/faqs.md
Outdated
A good troubleshooting tip is to just disable STUN, Direct connections, and even | ||
forcing websockets versus the embedded Tailscale DERP relay server. | ||
|
||
If using a `systemd` configuration of Coder's control plane, add these values to |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
What do you think about just giving the flag names and values without detailing various ways to set these. We can link to the configuration page for that if required. FAQs are usually brief.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I will condense.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Consolidated as table:
Flag | Value | Meaning |
---|---|---|
CODER_BLOCK_DIRECT |
true |
Blocks direct connections |
CODER_DERP_SERVER_STUN_ADDRESSES |
"disable" |
Disables STUN |
CODER_DERP_FORCE_WEBSOCKETS |
true |
Forces websockets over Tailscale DERP |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
a few more suggestions and good to merge. Thank you for doing this.
Overview
We need a top-level page in our docs to add common FAQs from customers and community members. These previously existed in @sharkymark's v2-templates repository. This PR migrates them to our official docs under a new "FAQs" tab.
I cleaned up some of the informal text to match the tone of our docs.
The formatting and content changes are minimal, open to feedback.