grepdemos · lizard-boy · Aug 23, 2024 · Aug 23, 2024 · Aug 23, 2024 · Aug 23, 2024
diff --git a/.github/workflows/typos.toml b/.github/workflows/typos.toml
@@ -22,6 +22,7 @@ pn = "pn"
 EDE = "EDE"
 # HELO is an SMTP command
 HELO = "HELO"
+LKE = "LKE"
 
 [files]
 extend-exclude = [

diff --git a/.vscode/settings.json b/.vscode/settings.json
@@ -6,6 +6,7 @@
 		"ASKPASS",
 		"authcheck",
 		"autostop",
+		"autoupdate",
 		"awsidentity",
 		"bodyclose",
 		"buildinfo",
@@ -14,22 +15,27 @@
 		"cliflag",
 		"cliui",
 		"codecov",
+		"codercom",
 		"coderd",
 		"coderdenttest",
 		"coderdtest",
 		"codersdk",
 		"contravariance",
 		"cronstrue",
 		"databasefake",
+		"dbcrypt",
 		"dbgen",
 		"dbmem",
 		"dbtype",
 		"DERP",
 		"derphttp",
 		"derpmap",
+		"devcontainers",
 		"devel",
 		"devtunnel",
 		"dflags",
+		"dogfood",
+		"dotfiles",
 		"drpc",
 		"drpcconn",
 		"drpcmux",
@@ -43,6 +49,7 @@
 		"externalauth",
 		"Failf",
 		"fatih",
+		"filebrowser",
 		"Formik",
 		"gitauth",
 		"gitsshkey",
@@ -63,9 +70,11 @@
 		"initialisms",
 		"ipnstate",
 		"isatty",
+		"jetbrains",
 		"Jobf",
 		"Keygen",
 		"kirsle",
+		"knowledgebase",
 		"Kubernetes",
 		"ldflags",
 		"magicsock",
@@ -77,6 +86,7 @@
 		"namesgenerator",
 		"namespacing",
 		"netaddr",
+		"netcheck",
 		"netip",
 		"netmap",
 		"netns",
@@ -93,13 +103,15 @@
 		"opty",
 		"paralleltest",
 		"parameterscopeid",
+		"portsharing",
 		"pqtype",
 		"prometheusmetrics",
 		"promhttp",
 		"protobuf",
 		"provisionerd",
 		"provisionerdserver",
 		"provisionersdk",
+		"ptrace",
 		"ptty",
 		"ptys",
 		"ptytest",
@@ -114,6 +126,7 @@
 		"Signup",
 		"slogtest",
 		"sourcemapped",
+		"speedtest",
 		"spinbutton",
 		"Srcs",
 		"stdbuf",
@@ -153,9 +166,10 @@
 		"turnconn",
 		"typegen",
 		"typesafe",
+		"unauthenticate",
 		"unconvert",
-		"Untar",
-		"Userspace",
+		"untar",
+		"userspace",
 		"VMID",
 		"walkthrough",
 		"weblinks",
@@ -171,6 +185,7 @@
 		"workspaceapps",
 		"workspacebuilds",
 		"workspacename",
+		"workspaceproxies",
 		"wsjson",
 		"xerrors",
 		"xlarge",

diff --git a/Makefile b/Makefile
@@ -492,9 +492,9 @@ gen: \
 	coderd/rbac/object_gen.go \
 	codersdk/rbacresources_gen.go \
 	site/src/api/rbacresourcesGenerated.ts \
-	docs/admin/prometheus.md \
+	docs/admin/integrations/prometheus.md \
 	docs/reference/cli/README.md \
-	docs/admin/audit-logs.md \
+	docs/admin/security/audit-logs.md \
 	coderd/apidoc/swagger.json \
 	.prettierignore.include \
 	.prettierignore \
@@ -521,9 +521,9 @@ gen/mark-fresh:
 		coderd/rbac/object_gen.go \
 		codersdk/rbacresources_gen.go \
 		site/src/api/rbacresourcesGenerated.ts \
-		docs/admin/prometheus.md \
+		docs/admin/integrations/prometheus.md \
 		docs/reference/cli/README.md \
-		docs/admin/audit-logs.md \
+		docs/admin/security/audit-logs.md \
 		coderd/apidoc/swagger.json \
 		.prettierignore.include \
 		.prettierignore \
@@ -624,21 +624,20 @@ codersdk/rbacresources_gen.go: scripts/rbacgen/codersdk.gotmpl scripts/rbacgen/m
 site/src/api/rbacresourcesGenerated.ts: scripts/rbacgen/codersdk.gotmpl scripts/rbacgen/main.go coderd/rbac/object.go coderd/rbac/policy/policy.go
 	go run scripts/rbacgen/main.go typescript > "$@"
 
-
 docs/admin/prometheus.md: scripts/metricsdocgen/main.go scripts/metricsdocgen/metrics
 	go run scripts/metricsdocgen/main.go
 	./scripts/pnpm_install.sh
-	pnpm exec prettier --write ./docs/admin/prometheus.md
+	pnpm exec prettier --write ./docs/admin/integrations/prometheus.md
 
 docs/reference/cli/README.md: scripts/clidocgen/main.go examples/examples.gen.json $(GO_SRC_FILES)
 	CI=true BASE_PATH="." go run ./scripts/clidocgen
 	./scripts/pnpm_install.sh
 	pnpm exec prettier --write ./docs/reference/cli/README.md ./docs/reference/cli/*.md ./docs/manifest.json
 
-docs/admin/audit-logs.md: coderd/database/querier.go scripts/auditdocgen/main.go enterprise/audit/table.go coderd/rbac/object_gen.go
+docs/admin/security/audit-logs.md: coderd/database/querier.go scripts/auditdocgen/main.go enterprise/audit/table.go coderd/rbac/object_gen.go
 	go run scripts/auditdocgen/main.go
 	./scripts/pnpm_install.sh
-	pnpm exec prettier --write ./docs/admin/audit-logs.md
+	pnpm exec prettier --write ./docs/admin/security/audit-logs.md
 
 coderd/apidoc/swagger.json: $(shell find ./scripts/apidocgen $(FIND_EXCLUSIONS) -type f) $(wildcard coderd/*.go) $(wildcard enterprise/coderd/*.go) $(wildcard codersdk/*.go) $(wildcard enterprise/wsproxy/wsproxysdk/*.go) $(DB_GEN_FILES) .swaggo docs/manifest.json coderd/rbac/object_gen.go
 	./scripts/apidocgen/generate.sh

diff --git a/docs/README.md b/docs/README.md
@@ -18,7 +18,7 @@ By building on top of common development interfaces (SSH) and infrastructure too
 ## How it works
 
 Coder workspaces are represented with Terraform, but no Terraform knowledge is
-required to get started. We have a database of pre-made templates built into the
+required to get started. We have a [database](https://registry.coder.com/templates) of pre-made templates built into the
 product.
 
 <p align="center">
@@ -28,11 +28,11 @@ product.
 Coder workspaces don't stop at compute. You can add storage buckets, secrets, sidecars
 and whatever else Terraform lets you dream up.
 
-[Learn more about managing infrastructure.](./templates/index.md)
+[Learn more about templates.](./admin/templates/README.md)
 
 ## IDE Support
 
-You can use any Web IDE ([code-server](https://github.com/coder/code-server), [projector](https://github.com/JetBrains/projector-server), [Jupyter](https://jupyter.org/), etc.), [JetBrains Gateway](https://www.jetbrains.com/remote-development/gateway/), [VS Code Remote](https://code.visualstudio.com/docs/remote/ssh-tutorial) or even a file sync such as [mutagen](https://mutagen.io/).
+You can use any [Web IDE](./admin/templates/extending-templates/web-ides.md) ([code-server](https://github.com/coder/code-server), [projector](https://github.com/JetBrains/projector-server), [Jupyter](https://jupyter.org), etc.), [JetBrains Gateway](https://www.jetbrains.com/remote-development/gateway/), [VS Code Remote](https://code.visualstudio.com/docs/remote/ssh-tutorial) or even a file sync such as [mutagen](https://mutagen.io/).
 
 <p align="center">
   <img src="./images/ide-icons.svg" height=72>
@@ -80,7 +80,7 @@ layer of infrastructure control. This additional layer allows admins to:
 - Enable persistent workspaces, which are like local machines, but faster and
   hosted by a cloud service
 
-Coder includes [production-ready templates](https://github.com/coder/coder/tree/c6b1daabc5a7aa67bfbb6c89966d728919ba7f80/examples/templates) for use with AWS EC2,
+Coder includes [production-ready templates](https://registry.coder.com/templates) for use with AWS EC2,
 Azure, Google Cloud, Kubernetes, and more.
 
 ## What Coder is _not_
@@ -104,5 +104,5 @@ Azure, Google Cloud, Kubernetes, and more.
 
 ## Up next
 
-- Learn about [Templates](./templates/index.md)
-- [Install Coder](./install/index.md#install-coder)
+- Learn about [Templates](./admin/templates/README.md)
+- [Install Coder](./install/README.md)
diff --git a/docs/admin/README.md b/docs/admin/README.md
@@ -1,5 +1,11 @@
-Get started with Coder administration:
+# Administration
 
-<children>
-  This page is rendered on https://coder.com/docs/admin. Refer to the other documents in the `admin/` directory.
-</children>
+These guides contain information on managing the Coder control plane and [authoring templates](./templates/README.md).
+
+First time viewers looking to set up control plane access can start with the [configuration guide](./setup.md). If you're a team lead looking to design environments for your developers, check out our [templates guides](./templates/README.md). If you are a developer using Coder, we recommend the [user guides](../user-guides/README.md).
+
+For automation and scripting workflows, see our [CLI](../reference/cli/README.md) and [API](../reference/api/README.md) docs.
+
+For any information not strictly contained in these sections, check out our [Tutorials](../tutorials/README.md) and [FAQs](../tutorials/faqs.md).
+
+<children></children>
diff --git a/docs/admin/app-logs.md b/docs/admin/app-logs.md
diff --git a/docs/admin/appearance.md b/docs/admin/appearance.md