Preface

We don't have much existing documentation around controlling workspace ports.

• Networking/Port Forwarding
• Workspaces - doesn't feature anything around ports

Since the Sharable Ports feature introduced two new axes of port manipulation, I think it warrants a new page to discuss both.

What to cover

• Screenshot of the new ports UI with various shared port configuration
• How to share a port at different levels
• Explanation of admin-level controls (maximum port sharing level)
• How sharable ports interacts with coder_apps
• Protocol control

Location/Design

Option 1

We append to the port forwarding page. I hesitate here because there's already so much content there.

Option 2

We create a new page under Networking for controlling workspace ports/services.

Option 3

We break the Workspaces page into subcategories:

• index.md: Creating, Viewing, Updating, Repairing, Logging, Resources
• scheduling.md: Workspace Scheduling
• access.md: Accessing workspaces via ports and coder_apps, links to IDEs page