Skip to content

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

Merged
merged 10 commits into from
Dec 13, 2023
Merged

docs: add faqs from sharkymark #11168

merged 10 commits into from
Dec 13, 2023

Conversation

stirby
Copy link
Collaborator

@stirby stirby commented Dec 12, 2023

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.

@stirby stirby requested a review from matifali December 12, 2023 21:38
Copy link
Member

@matifali matifali left a 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
Copy link
Member

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.

Copy link
Collaborator Author

Choose a reason for hiding this comment

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

I will condense.

Copy link
Collaborator Author

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

Copy link
Member

@matifali matifali left a 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.

@matifali matifali changed the title feat(docs): add faqs from sharkymark docs: add faqs from sharkymark Dec 13, 2023
@stirby stirby merged commit a3432b4 into main Dec 13, 2023
@stirby stirby deleted the faqs branch December 13, 2023 21:56
@github-actions github-actions bot locked and limited conversation to collaborators Dec 13, 2023
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants