mirror of
https://github.com/coder/coder.git
synced 2026-09-22 05:05:20 +08:00
Linked Linear issue: [DOCS-571](https://linear.app/codercom/issue/DOCS-571/add-coderdocs-as-a-codeowner-for-docs-content-and-tooling-in) ## What Adds `@coder/docs` as a CODEOWNER for documentation content and docs-specific tooling, so the docs team is automatically requested for review (and notified) whenever these paths change. ## Paths added - `/docs/` — documentation content - `/offlinedocs/` — offline docs app - `/.vale.ini`, `/.markdownlint.jsonc`, `/.markdownlint-cli2.jsonc` — prose/Markdown lint config - `scripts/clidocgen/`, `scripts/apidocgen/`, `scripts/auditdocgen/`, `scripts/metricsdocgen/`, `scripts/docgenenv/` — reference-docs generators + shared helper - Docs CI workflows, **co-owned with `@jdomeracki-coder`**: `.github/workflows/doc-check.yaml`, `docs-preview.yaml`, `deploy-docs.yaml`, `weekly-docs.yaml` Patterns are root-anchored and appended after the existing entries. The workflow lines co-own with `@jdomeracki-coder` (who owns `.github/`), so no existing ownership is removed. ## Out of scope - `.swaggo` (API swagger-gen config) — intentionally left with its current default ownership. ## Notes - Intended as **notify-only**: auto-requests `@coder/docs` for review on these paths. `main` does not enforce required code-owner review, so this does not gate merges. - Takes effect once merged to `main`, and only if `@coder/docs` has write access to this repo. _Opened as a draft._
70 lines
2.8 KiB
Plaintext
70 lines
2.8 KiB
Plaintext
# These APIs are versioned, so any changes need to be carefully reviewed for
|
|
# whether to bump API major or minor versions.
|
|
agent/proto/ @spikecurtis @johnstcn
|
|
provisionerd/proto/ @spikecurtis @johnstcn
|
|
provisionersdk/proto/ @spikecurtis @johnstcn
|
|
tailnet/proto/ @spikecurtis @johnstcn
|
|
vpn/vpn.proto @spikecurtis @johnstcn
|
|
vpn/version.go @spikecurtis @johnstcn
|
|
|
|
# This caching code is particularly tricky, and one must be very careful when
|
|
# altering it.
|
|
coderd/files/ @aslilac
|
|
|
|
coderd/dynamicparameters/ @Emyrk
|
|
coderd/rbac/ @Emyrk
|
|
|
|
# Mainly dependent on coder/guts, which is maintained by @Emyrk
|
|
scripts/apitypings/ @Emyrk
|
|
scripts/gensite/ @aslilac
|
|
|
|
# The blood and guts of the autostop algorithm, which is quite complex and
|
|
# requires elite ball knowledge of most of the scheduling code to make changes
|
|
# without inadvertently affecting other parts of the codebase.
|
|
coderd/schedule/autostop.go @deansheather @DanielleMaywood
|
|
|
|
# Usage tracking code requires intimate knowledge of Tallyman and Metronome, as
|
|
# well as guidance from revenue.
|
|
coderd/usage/ @deansheather @spikecurtis
|
|
enterprise/coderd/usage/ @deansheather @spikecurtis
|
|
|
|
site/src/pages/AgentsPage/ @DanielleMaywood
|
|
|
|
.github/ @jdomeracki-coder
|
|
|
|
# Shared contract between chatd and aibridge: AI provider configuration and
|
|
# model pricing, read by both. Note aicostcontrol.sql also carries group/user
|
|
# AI budget and spend queries alongside the ai_model_prices queries.
|
|
coderd/database/queries/ai_providers.sql @ibetitsmike @johnstcn
|
|
coderd/database/queries/ai_provider_keys.sql @ibetitsmike @johnstcn
|
|
coderd/database/queries/aicostcontrol.sql @ibetitsmike @johnstcn
|
|
codersdk/aiproviders.go @ibetitsmike @johnstcn
|
|
codersdk/aiproviders_bedrock.go @ibetitsmike @johnstcn
|
|
|
|
# Documentation content and docs-specific tooling are owned by the docs team so
|
|
# that @coder/docs is automatically requested for review on documentation
|
|
# changes. Paths are anchored to the repo root.
|
|
/docs/ @coder/docs
|
|
/offlinedocs/ @coder/docs
|
|
|
|
# Prose and Markdown linting configuration.
|
|
/.vale.ini @coder/docs
|
|
/.markdownlint.jsonc @coder/docs
|
|
/.markdownlint-cli2.jsonc @coder/docs
|
|
|
|
# Reference-docs generators (CLI, API, audit log, and Prometheus metrics docs)
|
|
# and their shared helper.
|
|
scripts/clidocgen/ @coder/docs
|
|
scripts/apidocgen/ @coder/docs
|
|
scripts/auditdocgen/ @coder/docs
|
|
scripts/metricsdocgen/ @coder/docs
|
|
scripts/docgenenv/ @coder/docs
|
|
|
|
# Docs-specific CI workflows. These sit under .github/ (owned above by
|
|
# @jdomeracki-coder), so the docs team is added as a co-owner to keep both
|
|
# parties notified of changes.
|
|
.github/workflows/doc-check.yaml @jdomeracki-coder @coder/docs
|
|
.github/workflows/docs-preview.yaml @jdomeracki-coder @coder/docs
|
|
.github/workflows/deploy-docs.yaml @jdomeracki-coder @coder/docs
|
|
.github/workflows/weekly-docs.yaml @jdomeracki-coder @coder/docs
|