Thanks to visit codestin.com
Credit goes to github.com

Skip to content

Commit fe265eb

Browse files
committed
wip 2
1 parent 687b015 commit fe265eb

File tree

18 files changed

+1231
-1212
lines changed

18 files changed

+1231
-1212
lines changed

.markdownlint.jsonc

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -8,6 +8,8 @@
88

99
"MD033": false, // Inline HTML: we use it in some places
1010

11+
"MD034": false, // Bare URL: we use it in some places in generated docs see: codersdk/deployment.go
12+
1113
"MD041": false, // First line in file should be a top level heading: All of our changelogs do not start with a top level heading
1214
// TODO: We need to update /home/coder/repos/coder/coder/scripts/release/generate_release_notes.sh to generate changelogs that follow this rule
1315

Makefile

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -685,9 +685,15 @@ codersdk/rbacresources_gen.go: scripts/typegen/codersdk.gotmpl scripts/typegen/m
685685

686686
site/src/api/rbacresourcesGenerated.ts: scripts/typegen/codersdk.gotmpl scripts/typegen/main.go coderd/rbac/object.go coderd/rbac/policy/policy.go
687687
go run scripts/typegen/main.go rbac typescript > "$@"
688+
cd site
689+
../scripts/pnpm_install.sh
690+
pnpm exec biome format --write src/api/rbacresourcesGenerated.ts
688691

689692
site/src/api/countriesGenerated.ts: scripts/typegen/countries.tstmpl scripts/typegen/main.go codersdk/countries.go
690693
go run scripts/typegen/main.go countries > "$@"
694+
cd site
695+
../scripts/pnpm_install.sh
696+
pnpm exec biome format --write src/api/countriesGenerated.ts
691697

692698
docs/admin/integrations/prometheus.md: scripts/metricsdocgen/main.go scripts/metricsdocgen/metrics
693699
go run scripts/metricsdocgen/main.go

cli/testdata/coder_server_--help.golden

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -56,7 +56,7 @@ OPTIONS:
5656

5757
--postgres-url string, $CODER_PG_CONNECTION_URL
5858
URL of a PostgreSQL database. If empty, PostgreSQL binaries will be
59-
downloaded from Maven <https://repo1.maven.org/maven2> and store all
59+
downloaded from Maven https://repo1.maven.org/maven2 and store all
6060
data in the config root. Access the built-in database with "coder
6161
server postgres-builtin-url". Note that any special characters in the
6262
URL must be URL-encoded.
@@ -215,7 +215,7 @@ INTROSPECTION / TRACING OPTIONS:
215215
--trace bool, $CODER_TRACE_ENABLE
216216
Whether application tracing data is collected. It exports to a backend
217217
configured by environment variables. See:
218-
<https://github.com/open-telemetry/opentelemetry-specification/blob/main/specification/protocol/exporter.md>.
218+
https://github.com/open-telemetry/opentelemetry-specification/blob/main/specification/protocol/exporter.md.
219219

220220
--trace-honeycomb-api-key string, $CODER_TRACE_HONEYCOMB_API_KEY
221221
Enables trace exporting to Honeycomb.io using the provided API Key.
@@ -269,11 +269,11 @@ backed by Tailscale and WireGuard.
269269

270270
--derp-config-path string, $CODER_DERP_CONFIG_PATH
271271
Path to read a DERP mapping from. See:
272-
<https://tailscale.com/kb/1118/custom-derp-servers/>.
272+
https://tailscale.com/kb/1118/custom-derp-servers/.
273273

274274
--derp-config-url string, $CODER_DERP_CONFIG_URL
275275
URL to fetch a DERP mapping on startup. See:
276-
<https://tailscale.com/kb/1118/custom-derp-servers/>.
276+
https://tailscale.com/kb/1118/custom-derp-servers/.
277277

278278
--derp-force-websockets bool, $CODER_DERP_FORCE_WEBSOCKETS
279279
Force clients and agents to always use WebSocket to connect to DERP
@@ -355,7 +355,7 @@ can safely ignore these settings.
355355
--tls-allow-insecure-ciphers bool, $CODER_TLS_ALLOW_INSECURE_CIPHERS (default: false)
356356
By default, only ciphers marked as 'secure' are allowed to be used.
357357
See
358-
<https://github.com/golang/go/blob/master/src/crypto/tls/cipher_suites.go#L82-L95>.
358+
https://github.com/golang/go/blob/master/src/crypto/tls/cipher_suites.go#L82-L95.
359359

360360
--tls-cert-file string-array, $CODER_TLS_CERT_FILE
361361
Path to each certificate for TLS. It requires a PEM-encoded file. To
@@ -365,7 +365,7 @@ can safely ignore these settings.
365365

366366
--tls-ciphers string-array, $CODER_TLS_CIPHERS
367367
Specify specific TLS ciphers that allowed to be used. See
368-
<https://github.com/golang/go/blob/master/src/crypto/tls/cipher_suites.go#L53-L75>.
368+
https://github.com/golang/go/blob/master/src/crypto/tls/cipher_suites.go#L53-L75.
369369

370370
--tls-client-auth string, $CODER_TLS_CLIENT_AUTH (default: none)
371371
Policy the server will follow for TLS Client Authentication. Accepted

cli/testdata/server-config.yaml.golden

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -90,11 +90,11 @@ networking:
9090
# (default: <unset>, type: string)
9191
clientKeyFile: ""
9292
# Specify specific TLS ciphers that allowed to be used. See
93-
# <https://github.com/golang/go/blob/master/src/crypto/tls/cipher_suites.go#L53-L75>.
93+
# https://github.com/golang/go/blob/master/src/crypto/tls/cipher_suites.go#L53-L75.
9494
# (default: <unset>, type: string-array)
9595
tlsCiphers: []
9696
# By default, only ciphers marked as 'secure' are allowed to be used. See
97-
# <https://github.com/golang/go/blob/master/src/crypto/tls/cipher_suites.go#L82-L95>.
97+
# https://github.com/golang/go/blob/master/src/crypto/tls/cipher_suites.go#L82-L95.
9898
# (default: false, type: bool)
9999
tlsAllowInsecureCiphers: false
100100
# Controls if the 'Strict-Transport-Security' header is set on all static file
@@ -157,11 +157,11 @@ networking:
157157
# (default: <unset>, type: bool)
158158
forceWebSockets: false
159159
# URL to fetch a DERP mapping on startup. See:
160-
# <https://tailscale.com/kb/1118/custom-derp-servers/>.
160+
# https://tailscale.com/kb/1118/custom-derp-servers/.
161161
# (default: <unset>, type: string)
162162
url: ""
163163
# Path to read a DERP mapping from. See:
164-
# <https://tailscale.com/kb/1118/custom-derp-servers/>.
164+
# https://tailscale.com/kb/1118/custom-derp-servers/.
165165
# (default: <unset>, type: string)
166166
configPath: ""
167167
# Headers to trust for forwarding IP addresses. e.g. Cf-Connecting-Ip,
@@ -217,7 +217,7 @@ introspection:
217217
tracing:
218218
# Whether application tracing data is collected. It exports to a backend
219219
# configured by environment variables. See:
220-
# <https://github.com/open-telemetry/opentelemetry-specification/blob/main/specification/protocol/exporter.md>.
220+
# https://github.com/open-telemetry/opentelemetry-specification/blob/main/specification/protocol/exporter.md.
221221
# (default: <unset>, type: bool)
222222
enable: false
223223
# Enables capturing of logs as events in traces. This is useful for debugging, but
@@ -499,9 +499,9 @@ supportLinks: []
499499
# External Authentication providers.
500500
# (default: <unset>, type: struct[[]codersdk.ExternalAuthConfig])
501501
externalAuthProviders: []
502-
# Hostname of HTTPS server that runs <https://github.com/coder/wgtunnel>. By
502+
# Hostname of HTTPS server that runs https://github.com/coder/wgtunnel. By
503503
# default, this will pick the best available wgtunnel server hosted by Coder. e.g.
504-
# <tunnel.example.com>.
504+
# tunnel.example.com.
505505
# (default: <unset>, type: string)
506506
wgtunnelHost: ""
507507
# Allow users to set quiet hours schedules each day for workspaces to avoid

coderd/apidoc/docs.go

Lines changed: 1 addition & 1 deletion
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

coderd/apidoc/swagger.json

Lines changed: 1 addition & 1 deletion
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

codersdk/deployment.go

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -594,7 +594,7 @@ type ExternalAuthConfig struct {
594594
// a string (e.g. coder.com) instead of by it's type.
595595
//
596596
// Git clone makes use of this by parsing the URL from:
597-
// 'Username for <https://github.com>:'
597+
// 'Username for https://github.com:'
598598
// And sending it to the Coder server to match against the Regex.
599599
Regex string `json:"regex" yaml:"regex"`
600600
// DisplayName is shown in the UI to identify the auth config.
@@ -1174,7 +1174,7 @@ when required by your organization's security policy.`,
11741174
Flag: "wildcard-access-url",
11751175
Env: "CODER_WILDCARD_ACCESS_URL",
11761176
// Do not use a serpent.URL here. We are intentionally omitting the
1177-
// scheme part of the url <https://>, so the standard url parsing
1177+
// scheme part of the url https://, so the standard url parsing
11781178
// will yield unexpected results.
11791179
//
11801180
// We have a validation function to ensure the wildcard url is correct,
@@ -1339,7 +1339,7 @@ when required by your organization's security policy.`,
13391339
},
13401340
{
13411341
Name: "TLS Ciphers",
1342-
Description: "Specify specific TLS ciphers that allowed to be used. See <https://github.com/golang/go/blob/master/src/crypto/tls/cipher_suites.go#L53-L75>.",
1342+
Description: "Specify specific TLS ciphers that allowed to be used. See https://github.com/golang/go/blob/master/src/crypto/tls/cipher_suites.go#L53-L75.",
13431343
Flag: "tls-ciphers",
13441344
Env: "CODER_TLS_CIPHERS",
13451345
Default: "",
@@ -1350,7 +1350,7 @@ when required by your organization's security policy.`,
13501350
},
13511351
{
13521352
Name: "TLS Allow Insecure Ciphers",
1353-
Description: "By default, only ciphers marked as 'secure' are allowed to be used. See <https://github.com/golang/go/blob/master/src/crypto/tls/cipher_suites.go#L82-L95>.",
1353+
Description: "By default, only ciphers marked as 'secure' are allowed to be used. See https://github.com/golang/go/blob/master/src/crypto/tls/cipher_suites.go#L82-L95.",
13541354
Flag: "tls-allow-insecure-ciphers",
13551355
Env: "CODER_TLS_ALLOW_INSECURE_CIPHERS",
13561356
Default: "false",
@@ -1452,7 +1452,7 @@ when required by your organization's security policy.`,
14521452
},
14531453
{
14541454
Name: "DERP Config URL",
1455-
Description: "URL to fetch a DERP mapping on startup. See: <https://tailscale.com/kb/1118/custom-derp-servers/>.",
1455+
Description: "URL to fetch a DERP mapping on startup. See: https://tailscale.com/kb/1118/custom-derp-servers/.",
14561456
Flag: "derp-config-url",
14571457
Env: "CODER_DERP_CONFIG_URL",
14581458
Value: &c.DERP.Config.URL,
@@ -1461,7 +1461,7 @@ when required by your organization's security policy.`,
14611461
},
14621462
{
14631463
Name: "DERP Config Path",
1464-
Description: "Path to read a DERP mapping from. See: <https://tailscale.com/kb/1118/custom-derp-servers/>.",
1464+
Description: "Path to read a DERP mapping from. See: https://tailscale.com/kb/1118/custom-derp-servers/.",
14651465
Flag: "derp-config-path",
14661466
Env: "CODER_DERP_CONFIG_PATH",
14671467
Value: &c.DERP.Config.Path,
@@ -1945,7 +1945,7 @@ when required by your organization's security policy.`,
19451945
// Trace settings
19461946
{
19471947
Name: "Trace Enable",
1948-
Description: "Whether application tracing data is collected. It exports to a backend configured by environment variables. See: <https://github.com/open-telemetry/opentelemetry-specification/blob/main/specification/protocol/exporter.md>.",
1948+
Description: "Whether application tracing data is collected. It exports to a backend configured by environment variables. See: https://github.com/open-telemetry/opentelemetry-specification/blob/main/specification/protocol/exporter.md.",
19491949
Flag: "trace",
19501950
Env: "CODER_TRACE_ENABLE",
19511951
Value: &c.Trace.Enable,
@@ -2284,7 +2284,7 @@ when required by your organization's security policy.`,
22842284
},
22852285
{
22862286
Name: "Postgres Connection URL",
2287-
Description: "URL of a PostgreSQL database. If empty, PostgreSQL binaries will be downloaded from Maven <https://repo1.maven.org/maven2> and store all data in the config root. Access the built-in database with \"coder server postgres-builtin-url\". Note that any special characters in the URL must be URL-encoded.",
2287+
Description: "URL of a PostgreSQL database. If empty, PostgreSQL binaries will be downloaded from Maven https://repo1.maven.org/maven2 and store all data in the config root. Access the built-in database with \"coder server postgres-builtin-url\". Note that any special characters in the URL must be URL-encoded.",
22882288
Flag: "postgres-url",
22892289
Env: "CODER_PG_CONNECTION_URL",
22902290
Annotations: serpent.Annotations{}.Mark(annotationSecretKey, "true"),
@@ -2530,7 +2530,7 @@ Write out the current server config as YAML to stdout.`,
25302530
},
25312531
{
25322532
Name: "Custom wgtunnel Host",
2533-
Description: "Hostname of HTTPS server that runs <https://github.com/coder/wgtunnel>. By default, this will pick the best available wgtunnel server hosted by Coder. e.g. <tunnel.example.com>.",
2533+
Description: "Hostname of HTTPS server that runs https://github.com/coder/wgtunnel. By default, this will pick the best available wgtunnel server hosted by Coder. e.g. tunnel.example.com.",
25342534
Flag: "wg-tunnel-host",
25352535
Env: "WGTUNNEL_HOST",
25362536
YAML: "wgtunnelHost",

docs/reference/api/schemas.md

Lines changed: 1 addition & 1 deletion
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

docs/reference/cli/server.md

Lines changed: 7 additions & 7 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

docs/reference/cli/templates_create.md

Lines changed: 1 addition & 1 deletion
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

docs/reference/cli/templates_edit.md

Lines changed: 1 addition & 1 deletion
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

0 commit comments

Comments
 (0)