Skip to content
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

docs: expandable content feedback from users #48644

Open
mmcallister opened this issue Nov 8, 2024 · 0 comments
Open

docs: expandable content feedback from users #48644

mmcallister opened this issue Nov 8, 2024 · 0 comments
Assignees

Comments

@mmcallister
Copy link
Contributor

We've gotten periodic feedback about content being hidden and missed in the expandable sections. Some examples:

the two sections about security best practices and shell completion are hidden in collapsible section, which is not obvious at first. Consider removing the collapsible/detail markdown directive. (/docs/reference/cli/)

Going forward, we shouldn't put content like warnings, best-practices, or similar important details in expandable sections as it could be missed.

what ports and address does the agent need? e.g. how to lock down outbound connections from agents to proxy (/docs/reference/networking/)

For this one, the info is there but it is hidden at first; it’s the only piece on the page presented in a collapsible section.

@mmcallister mmcallister self-assigned this Nov 8, 2024
@mmcallister mmcallister changed the title docs: Expandable content feedback from users docs: expandable content feedback from users Nov 8, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

1 participant