Skip to content

chore: update documentation links to the new format #13797

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 5 commits into from
Jul 10, 2024
Merged
Show file tree
Hide file tree
Changes from 1 commit
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Next Next commit
docs: update documentation links to remove version numbers
  • Loading branch information
matifali committed Jul 6, 2024
commit ef6de5d0083cf490ea8db65c93d0a8d6306407fe
2 changes: 1 addition & 1 deletion agent/agentscripts/agentscripts.go
Original file line number Diff line number Diff line change
Expand Up @@ -349,7 +349,7 @@ func (r *Runner) run(ctx context.Context, script codersdk.WorkspaceAgentScript)
"This usually means a child process was started with references to stdout or stderr. As a result, this " +
"process may now have been terminated. Consider redirecting the output or using a separate " +
"\"coder_script\" for the process, see " +
"https://coder.com/docs/v2/latest/templates/troubleshooting#startup-script-issues for more information.",
"https://coder.com/docs/templates/troubleshooting#startup-script-issues for more information.",
)
// Inform the user by propagating the message via log writers.
_, _ = fmt.Fprintf(cmd.Stderr, "WARNING: %s. %s\n", message, details)
Expand Down
8 changes: 4 additions & 4 deletions cli/cliui/agent.go
Original file line number Diff line number Diff line change
Expand Up @@ -116,7 +116,7 @@ func Agent(ctx context.Context, writer io.Writer, agentID uuid.UUID, opts AgentO
if agent.Status == codersdk.WorkspaceAgentTimeout {
now := time.Now()
sw.Log(now, codersdk.LogLevelInfo, "The workspace agent is having trouble connecting, wait for it to connect or restart your workspace.")
sw.Log(now, codersdk.LogLevelInfo, troubleshootingMessage(agent, "https://coder.com/docs/v2/latest/templates#agent-connection-issues"))
sw.Log(now, codersdk.LogLevelInfo, troubleshootingMessage(agent, "https://coder.com/docs/templates#agent-connection-issues"))
for agent.Status == codersdk.WorkspaceAgentTimeout {
if agent, err = fetch(); err != nil {
return xerrors.Errorf("fetch: %w", err)
Expand Down Expand Up @@ -212,13 +212,13 @@ func Agent(ctx context.Context, writer io.Writer, agentID uuid.UUID, opts AgentO
sw.Fail(stage, safeDuration(sw, agent.ReadyAt, agent.StartedAt))
// Use zero time (omitted) to separate these from the startup logs.
sw.Log(time.Time{}, codersdk.LogLevelWarn, "Warning: A startup script exited with an error and your workspace may be incomplete.")
sw.Log(time.Time{}, codersdk.LogLevelWarn, troubleshootingMessage(agent, "https://coder.com/docs/v2/latest/templates/troubleshooting#startup-script-exited-with-an-error"))
sw.Log(time.Time{}, codersdk.LogLevelWarn, troubleshootingMessage(agent, "https://coder.com/docs/templates/troubleshooting#startup-script-exited-with-an-error"))
default:
switch {
case agent.LifecycleState.Starting():
// Use zero time (omitted) to separate these from the startup logs.
sw.Log(time.Time{}, codersdk.LogLevelWarn, "Notice: The startup scripts are still running and your workspace may be incomplete.")
sw.Log(time.Time{}, codersdk.LogLevelWarn, troubleshootingMessage(agent, "https://coder.com/docs/v2/latest/templates/troubleshooting#your-workspace-may-be-incomplete"))
sw.Log(time.Time{}, codersdk.LogLevelWarn, troubleshootingMessage(agent, "https://coder.com/docs/templates/troubleshooting#your-workspace-may-be-incomplete"))
// Note: We don't complete or fail the stage here, it's
// intentionally left open to indicate this stage didn't
// complete.
Expand All @@ -240,7 +240,7 @@ func Agent(ctx context.Context, writer io.Writer, agentID uuid.UUID, opts AgentO
stage := "The workspace agent lost connection"
sw.Start(stage)
sw.Log(time.Now(), codersdk.LogLevelWarn, "Wait for it to reconnect or restart your workspace.")
sw.Log(time.Now(), codersdk.LogLevelWarn, troubleshootingMessage(agent, "https://coder.com/docs/v2/latest/templates/troubleshooting#agent-connection-issues"))
sw.Log(time.Now(), codersdk.LogLevelWarn, troubleshootingMessage(agent, "https://coder.com/docs/templates/troubleshooting#agent-connection-issues"))

disconnectedAt := agent.DisconnectedAt
for agent.Status == codersdk.WorkspaceAgentDisconnected {
Expand Down
2 changes: 1 addition & 1 deletion cli/dotfiles.go
Original file line number Diff line number Diff line change
Expand Up @@ -204,7 +204,7 @@ func (r *RootCmd) dotfiles() *serpent.Command {
}

if fi.Mode()&0o111 == 0 {
return xerrors.Errorf("script %q is not executable. See https://coder.com/docs/v2/latest/dotfiles for information on how to resolve the issue.", script)
return xerrors.Errorf("script %q is not executable. See https://coder.com/docs/dotfiles for information on how to resolve the issue.", script)
}

// it is safe to use a variable command here because it's from
Expand Down
2 changes: 1 addition & 1 deletion cli/server.go
Original file line number Diff line number Diff line change
Expand Up @@ -830,7 +830,7 @@ func (r *RootCmd) Server(newAPI func(context.Context, *coderd.Options) (*coderd.
}
defer options.Telemetry.Close()
} else {
logger.Warn(ctx, `telemetry disabled, unable to notify of security issues. Read more: https://coder.com/docs/v2/latest/admin/telemetry`)
logger.Warn(ctx, `telemetry disabled, unable to notify of security issues. Read more: https://coder.com/docs/admin/telemetry`)
}

// This prevents the pprof import from being accidentally deleted.
Expand Down
4 changes: 2 additions & 2 deletions coderd/healthcheck/health/model_test.go
Original file line number Diff line number Diff line change
Expand Up @@ -17,8 +17,8 @@ func Test_MessageURL(t *testing.T) {
base string
expected string
}{
{"empty", "", "", "https://coder.com/docs/v2/latest/admin/healthcheck#eunknown"},
{"default", health.CodeAccessURLFetch, "", "https://coder.com/docs/v2/latest/admin/healthcheck#eacs03"},
{"empty", "", "", "https://coder.com/docs/admin/healthcheck#eunknown"},
{"default", health.CodeAccessURLFetch, "", "https://coder.com/docs/admin/healthcheck#eacs03"},
{"custom docs base", health.CodeAccessURLFetch, "https://example.com/docs", "https://example.com/docs/admin/healthcheck#eacs03"},
} {
tt := tt
Expand Down
2 changes: 1 addition & 1 deletion codersdk/deployment.go
Original file line number Diff line number Diff line change
Expand Up @@ -1781,7 +1781,7 @@ when required by your organization's security policy.`,
Flag: "agent-fallback-troubleshooting-url",
Env: "CODER_AGENT_FALLBACK_TROUBLESHOOTING_URL",
Hidden: true,
Default: "https://coder.com/docs/v2/latest/templates/troubleshooting",
Default: "https://coder.com/docs/templates/troubleshooting",
Value: &c.AgentFallbackTroubleshootingURL,
YAML: "agentFallbackTroubleshootingURL",
},
Expand Down
20 changes: 10 additions & 10 deletions codersdk/healthsdk/healthsdk_test.go
Original file line number Diff line number Diff line change
Expand Up @@ -41,22 +41,22 @@ func TestSummarize(t *testing.T) {
expected := []string{
"Access URL: Error: test error",
"Access URL: Warn: TEST: testing",
"See: https://coder.com/docs/v2/latest/admin/healthcheck#test",
"See: https://coder.com/docs/admin/healthcheck#test",
"Database: Error: test error",
"Database: Warn: TEST: testing",
"See: https://coder.com/docs/v2/latest/admin/healthcheck#test",
"See: https://coder.com/docs/admin/healthcheck#test",
"DERP: Error: test error",
"DERP: Warn: TEST: testing",
"See: https://coder.com/docs/v2/latest/admin/healthcheck#test",
"See: https://coder.com/docs/admin/healthcheck#test",
"Provisioner Daemons: Error: test error",
"Provisioner Daemons: Warn: TEST: testing",
"See: https://coder.com/docs/v2/latest/admin/healthcheck#test",
"See: https://coder.com/docs/admin/healthcheck#test",
"Websocket: Error: test error",
"Websocket: Warn: TEST: testing",
"See: https://coder.com/docs/v2/latest/admin/healthcheck#test",
"See: https://coder.com/docs/admin/healthcheck#test",
"Workspace Proxies: Error: test error",
"Workspace Proxies: Warn: TEST: testing",
"See: https://coder.com/docs/v2/latest/admin/healthcheck#test",
"See: https://coder.com/docs/admin/healthcheck#test",
}
actual := hr.Summarize("")
assert.Equal(t, expected, actual)
Expand Down Expand Up @@ -93,9 +93,9 @@ func TestSummarize(t *testing.T) {
expected: []string{
"Error: testing",
"Warn: TEST01: testing one",
"See: https://coder.com/docs/v2/latest/admin/healthcheck#test01",
"See: https://coder.com/docs/admin/healthcheck#test01",
"Warn: TEST02: testing two",
"See: https://coder.com/docs/v2/latest/admin/healthcheck#test02",
"See: https://coder.com/docs/admin/healthcheck#test02",
},
},
{
Expand All @@ -117,9 +117,9 @@ func TestSummarize(t *testing.T) {
expected: []string{
"TEST: Error: testing",
"TEST: Warn: TEST01: testing one",
"See: https://coder.com/docs/v2/latest/admin/healthcheck#test01",
"See: https://coder.com/docs/admin/healthcheck#test01",
"TEST: Warn: TEST02: testing two",
"See: https://coder.com/docs/v2/latest/admin/healthcheck#test02",
"See: https://coder.com/docs/admin/healthcheck#test02",
},
},
} {
Expand Down
2 changes: 1 addition & 1 deletion docs/admin/auth.md
Original file line number Diff line number Diff line change
Expand Up @@ -321,7 +321,7 @@ OIDC provider will be added to the `myCoderGroupName` group in Coder.
### Group allowlist

You can limit which groups from your identity provider can log in to Coder with
[CODER_OIDC_ALLOWED_GROUPS](https://coder.com/docs/v2/latest/cli/server#--oidc-allowed-groups).
[CODER_OIDC_ALLOWED_GROUPS](https://coder.com/docs/cli/server#--oidc-allowed-groups).
Users who are not in a matching group will see the following error:

![Unauthorized group error](../images/admin/group-allowlist.png)
Expand Down
2 changes: 1 addition & 1 deletion docs/admin/external-auth.md
Original file line number Diff line number Diff line change
Expand Up @@ -185,7 +185,7 @@ CODER_EXTERNAL_AUTH_0_REGEX=github\.company\.org
### JFrog Artifactory

See
[this](https://coder.com/docs/v2/latest/guides/artifactory-integration#jfrog-oauth)
[this](https://coder.com/docs/guides/artifactory-integration#jfrog-oauth)
guide on instructions on how to set up for JFrog Artifactory.

### Custom scopes
Expand Down
2 changes: 1 addition & 1 deletion docs/architecture/architecture.md
Original file line number Diff line number Diff line change
Expand Up @@ -357,7 +357,7 @@ project-oriented [features](https://containers.dev/features) without requiring
platform administrators to push altered Docker images.

Learn more about
[Dev containers support](https://coder.com/docs/v2/latest/templates/dev-containers)
[Dev containers support](https://coder.com/docs/templates/dev-containers)
in Coder.

![Architecture Diagram](../images/architecture-devcontainers.png)
Expand Down
8 changes: 4 additions & 4 deletions docs/changelogs/v0.25.0.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@
- The `coder stat` fetches workspace utilization metrics, even from within a
container. Our example templates have been updated to use this to show CPU,
memory, disk via
[agent metadata](https://coder.com/docs/v2/latest/templates/agent-metadata)
[agent metadata](https://coder.com/docs/templates/agent-metadata)
(#8005)
- Helm: `coder.command` can specify a different command for the Coder pod
(#8116)
Expand All @@ -20,7 +20,7 @@
- Healthcheck endpoint has a database section: `/api/v2/debug/health`
- Force DERP connections in CLI with `--disable-direct` flag (#8131)
- Disable all direct connections for a Coder deployment with
[--block-direct-connections](https://coder.com/docs/v2/latest/cli/server#--block-direct-connections)
[--block-direct-connections](https://coder.com/docs/cli/server#--block-direct-connections)
(#7936)
- Search for workspaces based on last activity (#2658)
```text
Expand Down Expand Up @@ -83,6 +83,6 @@ Compare:

## Install/upgrade

Refer to our docs to [install](https://coder.com/docs/v2/latest/install) or
[upgrade](https://coder.com/docs/v2/latest/admin/upgrade) Coder, or use a
Refer to our docs to [install](https://coder.com/docs/install) or
[upgrade](https://coder.com/docs/admin/upgrade) Coder, or use a
release asset below.
10 changes: 5 additions & 5 deletions docs/changelogs/v0.26.0.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

### Important changes

- [Managed variables](https://coder.com/docs/v2/latest/templates/parameters#terraform-template-wide-variables)
- [Managed variables](https://coder.com/docs/templates/parameters#terraform-template-wide-variables)
are enabled by default. The following block within templates is obsolete and
can be removed from your templates:

Expand All @@ -16,13 +16,13 @@
> previously necessary to activate this additional feature.

- Our scale test CLI is
[experimental](https://coder.com/docs/v2/latest/contributing/feature-stages#experimental-features)
[experimental](https://coder.com/docs/contributing/feature-stages#experimental-features)
to allow for rapid iteration. You can still interact with it via
`coder exp scaletest` (#8339)

### Features

- [coder dotfiles](https://coder.com/docs/v2/latest/cli/dotfiles) can checkout a
- [coder dotfiles](https://coder.com/docs/cli/dotfiles) can checkout a
specific branch

### Bug fixes
Expand All @@ -49,6 +49,6 @@ Compare:

## Install/upgrade

Refer to our docs to [install](https://coder.com/docs/v2/latest/install) or
[upgrade](https://coder.com/docs/v2/latest/admin/upgrade) Coder, or use a
Refer to our docs to [install](https://coder.com/docs/install) or
[upgrade](https://coder.com/docs/admin/upgrade) Coder, or use a
release asset below.
6 changes: 3 additions & 3 deletions docs/changelogs/v0.26.1.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

### Features

- [Devcontainer templates](https://coder.com/docs/v2/latest/templates/dev-containers)
- [Devcontainer templates](https://coder.com/docs/templates/dev-containers)
for Coder (#8256)
- The dashboard will warn users when a workspace is unhealthy (#8422)
- Audit logs `resource_target` search query allows you to search by resource
Expand Down Expand Up @@ -31,6 +31,6 @@ Compare:

## Install/upgrade

Refer to our docs to [install](https://coder.com/docs/v2/latest/install) or
[upgrade](https://coder.com/docs/v2/latest/admin/upgrade) Coder, or use a
Refer to our docs to [install](https://coder.com/docs/install) or
[upgrade](https://coder.com/docs/admin/upgrade) Coder, or use a
release asset below.
16 changes: 8 additions & 8 deletions docs/changelogs/v0.27.0.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@
Agent logs can be pushed after a workspace has started (#8528)

> ⚠️ **Warning:** You will need to
> [update](https://coder.com/docs/v2/latest/install) your local Coder CLI v0.27
> [update](https://coder.com/docs/install) your local Coder CLI v0.27
> to connect via `coder ssh`.

### Features
Expand All @@ -24,7 +24,7 @@ Agent logs can be pushed after a workspace has started (#8528)
- Template version messages (#8435)
<img width="428" alt="252772262-087f1338-f1e2-49fb-81f2-358070a46484" src="https://github.com/coder/coder/assets/22407953/5f6e5e47-e61b-41f1-92fe-f624e92f8bd3">
- TTL and max TTL validation increased to 30 days (#8258)
- [Self-hosted docs](https://coder.com/docs/v2/latest/install/offline#offline-docs):
- [Self-hosted docs](https://coder.com/docs/install/offline#offline-docs):
Host your own copy of Coder's documentation in your own environment (#8527)
(#8601)
- Add custom coder bin path for `config-ssh` (#8425)
Expand Down Expand Up @@ -57,7 +57,7 @@ Agent logs can be pushed after a workspace has started (#8528)
Agent logs can be pushed after a workspace has started (#8528)

> ⚠️ **Warning:** You will need to
> [update](https://coder.com/docs/v2/latest/install) your local Coder CLI v0.27
> [update](https://coder.com/docs/install) your local Coder CLI v0.27
> to connect via `coder ssh`.

### Features
Expand All @@ -76,7 +76,7 @@ Agent logs can be pushed after a workspace has started (#8528)
- Template version messages (#8435)
<img width="428" alt="252772262-087f1338-f1e2-49fb-81f2-358070a46484" src="https://github.com/coder/coder/assets/22407953/5f6e5e47-e61b-41f1-92fe-f624e92f8bd3">
- TTL and max TTL validation increased to 30 days (#8258)
- [Self-hosted docs](https://coder.com/docs/v2/latest/install/offline#offline-docs):
- [Self-hosted docs](https://coder.com/docs/install/offline#offline-docs):
Host your own copy of Coder's documentation in your own environment (#8527)
(#8601)
- Add custom coder bin path for `config-ssh` (#8425)
Expand Down Expand Up @@ -115,8 +115,8 @@ Compare:

## Install/upgrade

Refer to our docs to [install](https://coder.com/docs/v2/latest/install) or
[upgrade](https://coder.com/docs/v2/latest/admin/upgrade) Coder, or use a
Refer to our docs to [install](https://coder.com/docs/install) or
[upgrade](https://coder.com/docs/admin/upgrade) Coder, or use a
release asset below.

- Custom API use cases (custom agent logs, CI/CD pipelines) (#8445)
Expand All @@ -132,6 +132,6 @@ Compare:

## Install/upgrade

Refer to our docs to [install](https://coder.com/docs/v2/latest/install) or
[upgrade](https://coder.com/docs/v2/latest/admin/upgrade) Coder, or use a
Refer to our docs to [install](https://coder.com/docs/install) or
[upgrade](https://coder.com/docs/admin/upgrade) Coder, or use a
release asset below.
4 changes: 2 additions & 2 deletions docs/changelogs/v0.27.1.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,6 +21,6 @@ Compare:

## Install/upgrade

Refer to our docs to [install](https://coder.com/docs/v2/latest/install) or
[upgrade](https://coder.com/docs/v2/latest/admin/upgrade) Coder, or use a
Refer to our docs to [install](https://coder.com/docs/install) or
[upgrade](https://coder.com/docs/admin/upgrade) Coder, or use a
release asset below.
4 changes: 2 additions & 2 deletions docs/changelogs/v0.27.3.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,6 +15,6 @@ Compare:

## Install/upgrade

Refer to our docs to [install](https://coder.com/docs/v2/latest/install) or
[upgrade](https://coder.com/docs/v2/latest/admin/upgrade) Coder, or use a
Refer to our docs to [install](https://coder.com/docs/install) or
[upgrade](https://coder.com/docs/admin/upgrade) Coder, or use a
release asset below.
20 changes: 10 additions & 10 deletions docs/changelogs/v2.0.0.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,10 +7,10 @@ we have outgrown development (v0.x) releases:
[happily support](https://coder.com/docs/admin/scaling/scale-utility#recent-scale-tests) 1000+ users
and workspace connections
- We have a full suite of
[paid features](https://coder.com/docs/v2/latest/enterprise) and enterprise
[paid features](https://coder.com/docs/enterprise) and enterprise
customers deployed in production
- Users depend on our CLI to
[automate Coder](https://coder.com/docs/v2/latest/admin/automation) in Ci/Cd
[automate Coder](https://coder.com/docs/admin/automation) in Ci/Cd
pipelines and templates

Why not v1.0? At the time of writing, our legacy product is currently on v1.34.
Expand Down Expand Up @@ -39,7 +39,7 @@ ben@coder.com!

### BREAKING CHANGES

- RBAC: The default [Member role](https://coder.com/docs/v2/latest/admin/users)
- RBAC: The default [Member role](https://coder.com/docs/admin/users)
can no longer see a list of all users in a Coder deployment. The Template
Admin role and above can still use the `Users` page in dashboard and query
users via the API (#8650) (@Emyrk)
Expand All @@ -52,19 +52,19 @@ ben@coder.com!
[Kubernetes example template](https://github.com/coder/coder/tree/main/examples/templates/kubernetes)
uses a `kubernetes_deployment` instead of `kubernetes_pod` since it works
best with
[log streaming](https://coder.com/docs/v2/latest/platforms/kubernetes/deployment-logs)
[log streaming](https://coder.com/docs/platforms/kubernetes/deployment-logs)
in Coder.

### Features

- Template insights: Admins can see daily active users, user latency, and
popular IDEs (#8722) (@BrunoQuaresma)
![Template insights](https://user-images.githubusercontent.com/22407953/258239988-69641bd6-28da-4c60-9ae7-c0b1bba53859.png)
- [Kubernetes log streaming](https://coder.com/docs/v2/latest/platforms/kubernetes/deployment-logs):
- [Kubernetes log streaming](https://coder.com/docs/platforms/kubernetes/deployment-logs):
Stream Kubernetes event logs to the Coder agent logs to reveal Kuernetes-level
issues such as ResourceQuota limitations, invalid images, etc.
![Kubernetes quota](https://raw.githubusercontent.com/coder/coder/main/docs/platforms/kubernetes/coder-logstream-kube-logs-quota-exceeded.png)
- [OIDC Role Sync](https://coder.com/docs/v2/latest/admin/auth#group-sync-enterprise)
- [OIDC Role Sync](https://coder.com/docs/admin/auth#group-sync-enterprise)
(Enterprise): Sync roles from your OIDC provider to Coder roles (e.g.
`Template Admin`) (#8595) (@Emyrk)
- Users can convert their accounts from username/password authentication to SSO
Expand All @@ -82,14 +82,14 @@ ben@coder.com!
- CLI: Added `--var` shorthand for `--variable` in
`coder templates <create/push>` CLI (#8710) (@ammario)
- Sever logs: Added fine-grained
[filtering](https://coder.com/docs/v2/latest/cli/server#-l---log-filter) with
[filtering](https://coder.com/docs/cli/server#-l---log-filter) with
Regex (#8748) (@ammario)
- d3991fac2 feat(coderd): add parameter insights to template insights (#8656)
(@mafredri)
- Agent metadata: In cases where Coder does not receive metadata in time, we
render the previous "stale" value. Stale values are grey versus the typical
green color. (#8745) (@BrunoQuaresma)
- [Open in Coder](https://coder.com/docs/v2/latest/templates/open-in-coder):
- [Open in Coder](https://coder.com/docs/templates/open-in-coder):
Generate a link that automatically creates a workspace on behalf of the user,
skipping the "Create Workspace" form (#8651) (@BrunoQuaresma)
![Open in Coder](https://user-images.githubusercontent.com/22407953/257410429-712de64d-ea2c-4520-8abf-0a9ba5a16e7a.png)-
Expand Down Expand Up @@ -147,6 +147,6 @@ Compare:

## Install/upgrade

Refer to our docs to [install](https://coder.com/docs/v2/latest/install) or
[upgrade](https://coder.com/docs/v2/latest/admin/upgrade) Coder, or use a
Refer to our docs to [install](https://coder.com/docs/install) or
[upgrade](https://coder.com/docs/admin/upgrade) Coder, or use a
release asset below.
Loading