From 7bb2ce93b6c253d3c0bab3d4451827b6633f542a Mon Sep 17 00:00:00 2001 From: Stephen Kirby Date: Tue, 1 Apr 2025 17:28:02 +0000 Subject: [PATCH 1/4] moved feature stages to install --- docs/manifest.json | 10 +++++----- .../components/FeatureStageBadge/FeatureStageBadge.tsx | 2 +- 2 files changed, 6 insertions(+), 6 deletions(-) diff --git a/docs/manifest.json b/docs/manifest.json index d6d7920522d54..9d4c9ad7a2f3d 100644 --- a/docs/manifest.json +++ b/docs/manifest.json @@ -16,11 +16,6 @@ "title": "Screenshots", "description": "View screenshots of the Coder platform", "path": "./start/screenshots.md" - }, - { - "title": "Feature stages", - "description": "Information about pre-GA stages.", - "path": "./about/feature-stages.md" } ] }, @@ -112,6 +107,11 @@ "description": "Learn about the Coder release channels and schedule", "path": "./install/releases.md", "icon_path": "./images/icons/star.svg" + }, + { + "title": "Feature stages", + "description": "Information about pre-GA stages.", + "path": "./about/feature-stages.md" } ] }, diff --git a/site/src/components/FeatureStageBadge/FeatureStageBadge.tsx b/site/src/components/FeatureStageBadge/FeatureStageBadge.tsx index 0d4ea98258ea8..81a5b887063a8 100644 --- a/site/src/components/FeatureStageBadge/FeatureStageBadge.tsx +++ b/site/src/components/FeatureStageBadge/FeatureStageBadge.tsx @@ -61,7 +61,7 @@ export const FeatureStageBadge: FC = ({

Date: Tue, 1 Apr 2025 19:30:51 +0000 Subject: [PATCH 2/4] move feature-stages to releases --- docs/admin/monitoring/notifications/index.md | 2 +- docs/changelogs/v0.26.0.md | 2 +- docs/changelogs/v2.10.0.md | 2 +- docs/changelogs/v2.9.0.md | 2 +- docs/install/cli.md | 2 +- docs/install/index.md | 2 +- docs/install/kubernetes.md | 2 +- docs/install/rancher.md | 2 +- docs/{about => install/releases}/feature-stages.md | 0 docs/install/{releases.md => releases/index.md} | 2 +- docs/manifest.json | 4 ++-- scripts/release/docs_update_experiments.sh | 2 +- site/src/components/FeatureStageBadge/FeatureStageBadge.tsx | 2 +- 13 files changed, 13 insertions(+), 13 deletions(-) rename docs/{about => install/releases}/feature-stages.md (100%) rename docs/install/{releases.md => releases/index.md} (97%) diff --git a/docs/admin/monitoring/notifications/index.md b/docs/admin/monitoring/notifications/index.md index ae5d9fc89a274..c7dd8fde7afb1 100644 --- a/docs/admin/monitoring/notifications/index.md +++ b/docs/admin/monitoring/notifications/index.md @@ -278,7 +278,7 @@ troubleshoot: `CODER_VERBOSE=true` or `--verbose` to output debug logs. 1. If you are on version 2.15.x, notifications must be enabled using the `notifications` - [experiment](../../../about/feature-stages.md#early-access-features). + [experiment](../../../install/releases/feature-stages.md#early-access-features). Notifications are enabled by default in Coder v2.16.0 and later. diff --git a/docs/changelogs/v0.26.0.md b/docs/changelogs/v0.26.0.md index 9a07e2ed9638c..b0c1c1f5e13ce 100644 --- a/docs/changelogs/v0.26.0.md +++ b/docs/changelogs/v0.26.0.md @@ -16,7 +16,7 @@ > previously necessary to activate this additional feature. - Our scale test CLI is - [experimental](https://coder.com/docs/about/feature-stages.md#early-access-features) + [experimental](https://coder.com/docs/install/releases/feature-stages#early-access-features) to allow for rapid iteration. You can still interact with it via `coder exp scaletest` (#8339) diff --git a/docs/changelogs/v2.10.0.md b/docs/changelogs/v2.10.0.md index 7ffe4ab2f2466..b273c9b752bb2 100644 --- a/docs/changelogs/v2.10.0.md +++ b/docs/changelogs/v2.10.0.md @@ -1,7 +1,7 @@ ## Changelog > [!NOTE] -> This is a mainline Coder release. We advise enterprise customers without a staging environment to install our [latest stable release](https://github.com/coder/coder/releases/latest) while we refine this version. Learn more about our [Release Schedule](../install/releases.md). +> This is a mainline Coder release. We advise enterprise customers without a staging environment to install our [latest stable release](https://github.com/coder/coder/releases/latest) while we refine this version. Learn more about our [Release Schedule](../install/releases/index.md). ### BREAKING CHANGES diff --git a/docs/changelogs/v2.9.0.md b/docs/changelogs/v2.9.0.md index 549f15c19c014..ec92da79028cb 100644 --- a/docs/changelogs/v2.9.0.md +++ b/docs/changelogs/v2.9.0.md @@ -61,7 +61,7 @@ ### Experimental features -The following features are hidden or disabled by default as we don't guarantee stability. Learn more about experiments in [our documentation](https://coder.com/docs/about/feature-stages.md#early-access-features). +The following features are hidden or disabled by default as we don't guarantee stability. Learn more about experiments in [our documentation](https://coder.com/docs/install/releases/feature-stages#early-access-features). - The `coder support` command generates a ZIP with deployment information, agent logs, and server config values for troubleshooting purposes. We will publish documentation on how it works (and un-hide the feature) in a future release (#12328) (@johnstcn) - Port sharing: Allow users to share ports running in their workspace with other Coder users (#11939) (#12119) (#12383) (@deansheather) (@f0ssel) diff --git a/docs/install/cli.md b/docs/install/cli.md index 9dbd51e2c3638..9ee914a80f326 100644 --- a/docs/install/cli.md +++ b/docs/install/cli.md @@ -3,7 +3,7 @@ A single CLI (`coder`) is used for both the Coder server and the client. We support two release channels: mainline and stable - read the -[Releases](./releases.md) page to learn more about which best suits your team. +[Releases](./releases/index.md) page to learn more about which best suits your team. ## Download the latest release from GitHub diff --git a/docs/install/index.md b/docs/install/index.md index 46476de0d22bb..ae64dd2bf5915 100644 --- a/docs/install/index.md +++ b/docs/install/index.md @@ -3,7 +3,7 @@ A single CLI (`coder`) is used for both the Coder server and the client. We support two release channels: mainline and stable - read the -[Releases](./releases.md) page to learn more about which best suits your team. +[Releases](./releases/index.md) page to learn more about which best suits your team. There are several ways to install Coder. Follow the steps on this page for a minimal installation of Coder, or for a step-by-step guide on how to install and diff --git a/docs/install/kubernetes.md b/docs/install/kubernetes.md index b3b176c35da24..176fc7c452805 100644 --- a/docs/install/kubernetes.md +++ b/docs/install/kubernetes.md @@ -123,7 +123,7 @@ details on the values that are available, or you can view the file directly. We support two release channels: mainline and stable - read the -[Releases](./releases.md) page to learn more about which best suits your team. +[Releases](./releases/index.md) page to learn more about which best suits your team. - **Mainline** Coder release: diff --git a/docs/install/rancher.md b/docs/install/rancher.md index 5a8832e81c526..d1cb471866329 100644 --- a/docs/install/rancher.md +++ b/docs/install/rancher.md @@ -136,7 +136,7 @@ kubectl create secret generic coder-db-url -n coder \ - **Mainline**: `2.20.x` - **Stable**: `2.19.x` - Learn more about release channels in the [Releases documentation](./releases.md). + Learn more about release channels in the [Releases documentation](./releases/index.md). 1. Select **Next** when your configuration is complete. diff --git a/docs/about/feature-stages.md b/docs/install/releases/feature-stages.md similarity index 100% rename from docs/about/feature-stages.md rename to docs/install/releases/feature-stages.md diff --git a/docs/install/releases.md b/docs/install/releases/index.md similarity index 97% rename from docs/install/releases.md rename to docs/install/releases/index.md index bc5ec291dd2e0..d6b493e71c93f 100644 --- a/docs/install/releases.md +++ b/docs/install/releases/index.md @@ -35,7 +35,7 @@ only for security issues or CVEs. - In-product security vulnerabilities and CVEs are supported For more information on feature rollout, see our -[feature stages documentation](../about/feature-stages.md). +[feature stages documentation](../releases/feature-stages.md). ## Installing stable diff --git a/docs/manifest.json b/docs/manifest.json index 9d4c9ad7a2f3d..950ecd4f7cc79 100644 --- a/docs/manifest.json +++ b/docs/manifest.json @@ -105,13 +105,13 @@ { "title": "Releases", "description": "Learn about the Coder release channels and schedule", - "path": "./install/releases.md", + "path": "./install/releases/index.md", "icon_path": "./images/icons/star.svg" }, { "title": "Feature stages", "description": "Information about pre-GA stages.", - "path": "./about/feature-stages.md" + "path": "./install/releases/feature-stages.md" } ] }, diff --git a/scripts/release/docs_update_experiments.sh b/scripts/release/docs_update_experiments.sh index 1c6afdb87b181..1e5e6d1eb6b3e 100755 --- a/scripts/release/docs_update_experiments.sh +++ b/scripts/release/docs_update_experiments.sh @@ -94,7 +94,7 @@ parse_experiments() { } workdir=build/docs/experiments -dest=docs/about/feature-stages.md +dest=docs/install/releases/feature-stages.md log "Updating available experimental features in ${dest}" diff --git a/site/src/components/FeatureStageBadge/FeatureStageBadge.tsx b/site/src/components/FeatureStageBadge/FeatureStageBadge.tsx index 81a5b887063a8..25339d3120778 100644 --- a/site/src/components/FeatureStageBadge/FeatureStageBadge.tsx +++ b/site/src/components/FeatureStageBadge/FeatureStageBadge.tsx @@ -61,7 +61,7 @@ export const FeatureStageBadge: FC = ({

Date: Tue, 1 Apr 2025 19:33:38 +0000 Subject: [PATCH 3/4] update manifest --- docs/manifest.json | 14 ++++++++------ 1 file changed, 8 insertions(+), 6 deletions(-) diff --git a/docs/manifest.json b/docs/manifest.json index 950ecd4f7cc79..ce2da8303e4d1 100644 --- a/docs/manifest.json +++ b/docs/manifest.json @@ -106,12 +106,14 @@ "title": "Releases", "description": "Learn about the Coder release channels and schedule", "path": "./install/releases/index.md", - "icon_path": "./images/icons/star.svg" - }, - { - "title": "Feature stages", - "description": "Information about pre-GA stages.", - "path": "./install/releases/feature-stages.md" + "icon_path": "./images/icons/star.svg", + "children": [ + { + "title": "Feature stages", + "description": "Information about pre-GA stages.", + "path": "./install/releases/feature-stages.md" + } + ] } ] }, From 6e1472c82f2c42cc73efaed146bdade75433cca4 Mon Sep 17 00:00:00 2001 From: EdwardAngert <17991901+EdwardAngert@users.noreply.github.com> Date: Tue, 1 Apr 2025 21:16:45 +0000 Subject: [PATCH 4/4] fix links --- docs/install/releases/feature-stages.md | 6 +++--- docs/install/releases/index.md | 2 +- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/install/releases/feature-stages.md b/docs/install/releases/feature-stages.md index 7b83cadf3c7aa..5730a5d76288e 100644 --- a/docs/install/releases/feature-stages.md +++ b/docs/install/releases/feature-stages.md @@ -35,7 +35,7 @@ staging deployment.
To enable early access features: -Use the [Coder CLI](../install/cli.md) `--experiments` flag to enable early access features: +Use the [Coder CLI](../../install/cli.md) `--experiments` flag to enable early access features: - Enable all early access features: @@ -49,7 +49,7 @@ Use the [Coder CLI](../install/cli.md) `--experiments` flag to enable early acce coder server --experiments=feature1,feature2 ``` -You can also use the `CODER_EXPERIMENTS` [environment variable](../admin/setup/index.md). +You can also use the `CODER_EXPERIMENTS` [environment variable](../../admin/setup/index.md). You can opt-out of a feature after you've enabled it. @@ -101,7 +101,7 @@ If your Coder license includes an SLA, please consult it for an outline of speci For support, consult our knowledgeable and growing community on [Discord](https://discord.gg/coder), or create a [GitHub issue](https://github.com/coder/coder/issues) if one doesn't exist already. Customers with a valid Coder license, can submit a support request or contact your [account team](https://coder.com/contact). -We intend [Coder documentation](../README.md) to be the [single source of truth](https://en.wikipedia.org/wiki/Single_source_of_truth) and all features should have some form of complete documentation that outlines how to use or implement a feature. +We intend [Coder documentation](../../README.md) to be the [single source of truth](https://en.wikipedia.org/wiki/Single_source_of_truth) and all features should have some form of complete documentation that outlines how to use or implement a feature. If you discover an error or if you have a suggestion that could improve the documentation, please [submit a GitHub issue](https://github.com/coder/internal/issues/new?title=request%28docs%29%3A+request+title+here&labels=["customer-feedback","docs"]&body=please+enter+your+request+here). Some GA features can be disabled for air-gapped deployments. diff --git a/docs/install/releases/index.md b/docs/install/releases/index.md index d6b493e71c93f..d0ab0d1a05d5e 100644 --- a/docs/install/releases/index.md +++ b/docs/install/releases/index.md @@ -49,7 +49,7 @@ latest stable release: curl -fsSL https://coder.com/install.sh | sh -s -- --stable ``` -Best practices for installing Coder can be found on our [install](./index.md) +Best practices for installing Coder can be found on our [install](../index.md) pages. ## Release schedule