refactor: only show version requirements for new resources

blink-so[bot] · matifali · blink-so[bot] · commit e050d7438900 · 2025-06-27T16:06:38.000Z
Removed version requirements from resources that existed before Coder v2.0, as these requirements are not meaningful for established resources. Changes: - Updated docsgen to only add version notes when @SInCE: marker is present - Removed default v2.18.0 version assignment - Added @SInCE:v2.8.0 to workspace_preset data source - Updated documentation to clarify when to add version markers Now only resources/features introduced after v2.0 show version requirements: - coder_ai_task (v2.24.0) - coder_devcontainer (v2.21.0) - coder_workspace_preset (v2.8.0) - coder_app.hidden attribute (v2.16.0) Co-authored-by: matifali <10648092+matifali@users.noreply.github.com>
diff --git a/docs/data-sources/external_auth.md b/docs/data-sources/external_auth.md
@@ -10,8 +10,6 @@ description: |-
 
 Use this data source to require users to authenticate with an external service prior to workspace creation. This can be used to [pre-authenticate external services](https://coder.com/docs/admin/external-auth) in a workspace. (e.g. Google Cloud, Github, Docker, etc.)
 
-~> **Note:** This data source requires [Coder v2.18.0](https://github.com/coder/coder/releases/tag/v2.18.0) or later.
-
 ## Example Usage
 
 ```terraform
diff --git a/docs/data-sources/parameter.md b/docs/data-sources/parameter.md
@@ -10,8 +10,6 @@ description: |-
 
 Use this data source to configure editable options for workspaces.
 
-~> **Note:** This data source requires [Coder v2.18.0](https://github.com/coder/coder/releases/tag/v2.18.0) or later.
-
 ## Example Usage
 
 ```terraform
diff --git a/docs/data-sources/provisioner.md b/docs/data-sources/provisioner.md
@@ -10,8 +10,6 @@ description: |-
 
 Use this data source to get information about the Coder provisioner.
 
-~> **Note:** This data source requires [Coder v2.18.0](https://github.com/coder/coder/releases/tag/v2.18.0) or later.
-
 ## Example Usage
 
 ```terraform
diff --git a/docs/data-sources/workspace.md b/docs/data-sources/workspace.md
@@ -10,8 +10,6 @@ description: |-
 
 Use this data source to get information for the active workspace build.
 
-~> **Note:** This data source requires [Coder v2.18.0](https://github.com/coder/coder/releases/tag/v2.18.0) or later.
-
 ## Example Usage
 
 ```terraform
diff --git a/docs/data-sources/workspace_owner.md b/docs/data-sources/workspace_owner.md
@@ -10,8 +10,6 @@ description: |-
 
 Use this data source to fetch information about the workspace owner.
 
-~> **Note:** This data source requires [Coder v2.18.0](https://github.com/coder/coder/releases/tag/v2.18.0) or later.
-
 ## Example Usage
 
 ```terraform
diff --git a/docs/data-sources/workspace_preset.md b/docs/data-sources/workspace_preset.md
@@ -3,14 +3,14 @@
 page_title: "coder_workspace_preset Data Source - terraform-provider-coder"
 subcategory: ""
 description: |-
-  Use this data source to predefine common configurations for coder workspaces. Users will have the option to select a defined preset, which will automatically apply the selected configuration. Any parameters defined in the preset will be applied to the workspace. Parameters that are defined by the template but not defined by the preset will still be configurable when creating a workspace.
+  Use this data source to predefine common configurations for coder workspaces. Users will have the option to select a defined preset, which will automatically apply the selected configuration. Any parameters defined in the preset will be applied to the workspace. Parameters that are defined by the template but not defined by the preset will still be configurable when creating a workspace. @since:v2.8.0
 ---
 
 # coder_workspace_preset (Data Source)
 
-Use this data source to predefine common configurations for coder workspaces. Users will have the option to select a defined preset, which will automatically apply the selected configuration. Any parameters defined in the preset will be applied to the workspace. Parameters that are defined by the template but not defined by the preset will still be configurable when creating a workspace.
+Use this data source to predefine common configurations for coder workspaces. Users will have the option to select a defined preset, which will automatically apply the selected configuration. Any parameters defined in the preset will be applied to the workspace. Parameters that are defined by the template but not defined by the preset will still be configurable when creating a workspace. @since:v2.8.0
 
-~> **Note:** This data source requires [Coder v2.18.0](https://github.com/coder/coder/releases/tag/v2.18.0) or later.
+~> **Note:** This data source requires [Coder v2.8.0](https://github.com/coder/coder/releases/tag/v2.8.0) or later.
 
 ## Example Usage
 
diff --git a/docs/data-sources/workspace_tags.md b/docs/data-sources/workspace_tags.md
@@ -10,8 +10,6 @@ description: |-
 
 Use this data source to configure workspace tags to select provisioners.
 
-~> **Note:** This data source requires [Coder v2.18.0](https://github.com/coder/coder/releases/tag/v2.18.0) or later.
-
 ## Example Usage
 
 ```terraform
diff --git a/docs/resources/agent.md b/docs/resources/agent.md
@@ -10,8 +10,6 @@ description: |-
 
 Use this resource to associate an agent.
 
-~> **Note:** This resource requires [Coder v2.18.0](https://github.com/coder/coder/releases/tag/v2.18.0) or later.
-
 ## Example Usage
 
 ```terraform
diff --git a/docs/resources/agent_instance.md b/docs/resources/agent_instance.md
@@ -10,8 +10,6 @@ description: |-
 
 Use this resource to associate an instance ID with an agent for zero-trust authentication. This association is done automatically for `"google_compute_instance"`, `"aws_instance"`, `"azurerm_linux_virtual_machine"`, and `"azurerm_windows_virtual_machine"` resources.
 
-~> **Note:** This resource requires [Coder v2.18.0](https://github.com/coder/coder/releases/tag/v2.18.0) or later.
-
 ## Example Usage
 
 ```terraform
diff --git a/docs/resources/app.md b/docs/resources/app.md
@@ -10,8 +10,6 @@ description: |-
 
 Use this resource to define shortcuts to access applications in a workspace.
 
-~> **Note:** This resource requires [Coder v2.18.0](https://github.com/coder/coder/releases/tag/v2.18.0) or later.
-
 ## Example Usage
 
 ```terraform
diff --git a/docs/resources/env.md b/docs/resources/env.md
@@ -10,8 +10,6 @@ description: |-
 
 Use this resource to set an environment variable in a workspace. Note that this resource cannot be used to overwrite existing environment variables set on the `coder_agent` resource.
 
-~> **Note:** This resource requires [Coder v2.18.0](https://github.com/coder/coder/releases/tag/v2.18.0) or later.
-
 ## Example Usage
 
 ```terraform
diff --git a/docs/resources/metadata.md b/docs/resources/metadata.md
@@ -11,8 +11,6 @@ description: |-
 
 Use this resource to attach metadata to a resource. They will be displayed in the Coder dashboard alongside the resource. The resource containing the agent, and it's metadata, will be shown by default. 
 
-~> **Note:** This resource requires [Coder v2.18.0](https://github.com/coder/coder/releases/tag/v2.18.0) or later.
-
 Alternatively, to attach metadata to the agent, use a `metadata` block within a `coder_agent` resource.
 
 ## Example Usage
diff --git a/docs/resources/script.md b/docs/resources/script.md
@@ -10,8 +10,6 @@ description: |-
 
 Use this resource to run a script from an agent. When multiple scripts are assigned to the same agent, they are executed in parallel.
 
-~> **Note:** This resource requires [Coder v2.18.0](https://github.com/coder/coder/releases/tag/v2.18.0) or later.
-
 ## Example Usage
 
 ```terraform
diff --git a/provider/VERSION_METADATA.md b/provider/VERSION_METADATA.md
@@ -86,13 +86,12 @@ Results in documentation with:
 - `advanced_option` (Boolean) Enable advanced features. *(since v2.22.0)*
 ```
 
-## Default Versions
+## When to Add Version Information
 
-- Resources without `@since:` markers default to `v2.18.0` (the base requirement)
-- Attributes without `@since:` markers don't show version information
-- Special resources have hardcoded defaults:
-  - `coder_devcontainer`: v2.21.0
-  - `coder_ai_task`: v2.24.0
+- **Add @since: markers** for resources introduced after Coder v2.0
+- **Add @since: markers** for attributes added to existing resources
+- **Don't add markers** for resources that existed before Coder v2.0
+- Resources and attributes without `@since:` markers won't show version information
 
 ## Best Practices
 
diff --git a/provider/version_meta.go b/provider/version_meta.go
@@ -17,4 +17,7 @@ const (
 	
 	// V2_24_0 introduced AI task resources
 	V2_24_0 = "v2.24.0"
+	
+	// V2_8_0 introduced workspace preset data source
+	V2_8_0 = "v2.8.0"
 )
diff --git a/provider/workspace_preset.go b/provider/workspace_preset.go
@@ -58,7 +58,7 @@ func workspacePresetDataSource() *schema.Resource {
 	return &schema.Resource{
 		SchemaVersion: 1,
 
-		Description: "Use this data source to predefine common configurations for coder workspaces. Users will have the option to select a defined preset, which will automatically apply the selected configuration. Any parameters defined in the preset will be applied to the workspace. Parameters that are defined by the template but not defined by the preset will still be configurable when creating a workspace.",
+		Description: "Use this data source to predefine common configurations for coder workspaces. Users will have the option to select a defined preset, which will automatically apply the selected configuration. Any parameters defined in the preset will be applied to the workspace. Parameters that are defined by the template but not defined by the preset will still be configurable when creating a workspace. @since:v2.8.0",
 
 		ReadContext: func(ctx context.Context, rd *schema.ResourceData, i interface{}) diag.Diagnostics {
 			var preset WorkspacePreset
diff --git a/scripts/docsgen/main.go b/scripts/docsgen/main.go
@@ -110,13 +110,11 @@ func processVersionInformation(p *schema.Provider) error {
 		
 		// Extract version from description
 		version := extractVersionFromDescription(dataSource.Description)
-		if version == "" {
-			// Default to v2.18.0 if no version specified
-			version = "v2.18.0"
-		}
-		
-		if err := addVersionToResourceDoc(docFile, dataSourceName, version, "data source"); err != nil {
-			return xerrors.Errorf("unable to add version to data-source doc file (data-source: %s): %w", dataSourceName, err)
+		if version != "" {
+			// Only add version note if explicitly specified
+			if err := addVersionToResourceDoc(docFile, dataSourceName, version, "data source"); err != nil {
+				return xerrors.Errorf("unable to add version to data-source doc file (data-source: %s): %w", dataSourceName, err)
+			}
 		}
 		
 		// Process attributes for version info
@@ -131,22 +129,13 @@ func processVersionInformation(p *schema.Provider) error {
 		
 		// Extract version from description
 		version := extractVersionFromDescription(resource.Description)
-		if version == "" {
-			// Check for special cases
-			switch resourceName {
-			case "coder_devcontainer":
-				version = "v2.21.0"
-			case "coder_ai_task":
-				version = "v2.24.0"
-			default:
-				version = "v2.18.0"
+		if version != "" {
+			// Only add version note if explicitly specified
+			if err := addVersionToResourceDoc(docFile, resourceName, version, "resource"); err != nil {
+				return xerrors.Errorf("unable to add version to resource doc file (resource: %s): %w", resourceName, err)
 			}
 		}
 		
-		if err := addVersionToResourceDoc(docFile, resourceName, version, "resource"); err != nil {
-			return xerrors.Errorf("unable to add version to resource doc file (resource: %s): %w", resourceName, err)
-		}
-		
 		// Process attributes for version info
 		if err := processAttributeVersions(docFile, resource.Schema); err != nil {
 			return xerrors.Errorf("unable to process attribute versions for resource (resource: %s): %w", resourceName, err)
