Skip to content

Commit 3479450

Browse files
committed
rebase
1 parent 5710a98 commit 3479450

File tree

251 files changed

+15983
-15357
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

251 files changed

+15983
-15357
lines changed

Makefile

Lines changed: 7 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -492,9 +492,9 @@ gen: \
492492
coderd/rbac/object_gen.go \
493493
codersdk/rbacresources_gen.go \
494494
site/src/api/rbacresourcesGenerated.ts \
495-
docs/admin/prometheus.md \
495+
docs/admin/integrations/prometheus.md \
496496
docs/reference/cli/README.md \
497-
docs/admin/audit-logs.md \
497+
docs/admin/security/audit-logs.md \
498498
coderd/apidoc/swagger.json \
499499
.prettierignore.include \
500500
.prettierignore \
@@ -521,9 +521,9 @@ gen/mark-fresh:
521521
coderd/rbac/object_gen.go \
522522
codersdk/rbacresources_gen.go \
523523
site/src/api/rbacresourcesGenerated.ts \
524-
docs/admin/prometheus.md \
524+
docs/admin/integrations/prometheus.md \
525525
docs/reference/cli/README.md \
526-
docs/admin/audit-logs.md \
526+
docs/admin/security/audit-logs.md \
527527
coderd/apidoc/swagger.json \
528528
.prettierignore.include \
529529
.prettierignore \
@@ -624,21 +624,20 @@ codersdk/rbacresources_gen.go: scripts/rbacgen/codersdk.gotmpl scripts/rbacgen/m
624624
site/src/api/rbacresourcesGenerated.ts: scripts/rbacgen/codersdk.gotmpl scripts/rbacgen/main.go coderd/rbac/object.go coderd/rbac/policy/policy.go
625625
go run scripts/rbacgen/main.go typescript > "$@"
626626

627-
628627
docs/admin/prometheus.md: scripts/metricsdocgen/main.go scripts/metricsdocgen/metrics
629628
go run scripts/metricsdocgen/main.go
630629
./scripts/pnpm_install.sh
631-
pnpm exec prettier --write ./docs/admin/prometheus.md
630+
pnpm exec prettier --write ./docs/admin/integrations/prometheus.md
632631

633632
docs/reference/cli/README.md: scripts/clidocgen/main.go examples/examples.gen.json $(GO_SRC_FILES)
634633
CI=true BASE_PATH="." go run ./scripts/clidocgen
635634
./scripts/pnpm_install.sh
636635
pnpm exec prettier --write ./docs/reference/cli/README.md ./docs/reference/cli/*.md ./docs/manifest.json
637636

638-
docs/admin/audit-logs.md: coderd/database/querier.go scripts/auditdocgen/main.go enterprise/audit/table.go coderd/rbac/object_gen.go
637+
docs/admin/security/audit-logs.md: coderd/database/querier.go scripts/auditdocgen/main.go enterprise/audit/table.go coderd/rbac/object_gen.go
639638
go run scripts/auditdocgen/main.go
640639
./scripts/pnpm_install.sh
641-
pnpm exec prettier --write ./docs/admin/audit-logs.md
640+
pnpm exec prettier --write ./docs/admin/security/audit-logs.md
642641

643642
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
644643
./scripts/apidocgen/generate.sh

docs/README.md

Lines changed: 10 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,12 @@
1-
# About Coder
1+
# Coder Docs Landing
2+
3+
TODO: Make this a landing page with links to relevant docs, see
4+
5+
- [Docker](https://docs.docker.com/)
6+
- [Vercel](https://vercel.com/docs)
7+
-
8+
9+
<!-- # About Coder
210
311
Coder is an open-source platform for creating and managing developer workspaces
412
on your preferred clouds and servers.
@@ -105,4 +113,4 @@ Azure, Google Cloud, Kubernetes, and more.
105113
## Up next
106114
107115
- Learn about [Templates](./templates/index.md)
108-
- [Install Coder](./install/index.md#install-coder)
116+
- [Install Coder](./install/index.md#install-coder) -->

docs/admin/README.md

Lines changed: 39 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,40 @@
1-
Get started with Coder administration:
1+
# Administration
22

3-
<children>
4-
This page is rendered on https://coder.com/docs/admin. Refer to the other documents in the `admin/` directory.
5-
</children>
3+
Guides for day 2+ operations with Coder, including preparing for production and scaling to thousands of daily active users.
4+
5+
## Prerequisites
6+
7+
## Table of contents
8+
9+
- Infrastructure & Scale
10+
- Kubernetes Best Practices
11+
- Reference Architectures (up to 3000 users)
12+
- VM Best Practices
13+
- Optimize networking & latency
14+
- Add workspace regions
15+
- Add Kubernetes clusters
16+
- Scale testing your Coder deployment
17+
- User Management
18+
- Set up OpenID Connect (SSO)
19+
- Configure Group & Role Sync
20+
- Configure Template Permissions
21+
- Workspace Management
22+
- Keep workspaces up to date
23+
- Clean up unused workspaces
24+
- Template & Image Management
25+
- Building golden images
26+
- Add Dev Container support (custom dependencies)
27+
- Manage templates with Ci/Cd pipelines
28+
- Security
29+
- Auditing Coder users
30+
- Managing cloud secrets
31+
- Manage workspace secrets
32+
- Security flags
33+
- Monitoring
34+
- Configure server logging
35+
- Troubleshooting Templates
36+
- Monitoring via Prometheus / Grafana
37+
- Analytics
38+
- Measure user adoption (weekly active users)
39+
- Identifying Coder power users
40+
- Reading template usage metrics

docs/admin/app-logs.md

Lines changed: 0 additions & 33 deletions
This file was deleted.

docs/admin/appearance.md

Lines changed: 0 additions & 99 deletions
This file was deleted.

docs/admin/automation.md

Lines changed: 0 additions & 107 deletions
This file was deleted.

0 commit comments

Comments
 (0)