docs: Document conflict resolution between installCRDs and crds.enabled fields

Author: rshade

README.md

@@ -1,4 +1,4 @@
-# Pulumi Cert Manager Component
+## Pulumi Cert Manager Component
 
 This repo contains the Pulumi Cert Manager component for Kubernetes. This add-on automates the
 management and issuance of TLS certificates from various issuing sources. It ensures certificates
@@ -50,6 +50,7 @@ const cm = new certmanager.CertManager("cert-manager-deployment", {
     },
 
     // Option 2: Using deprecated option (not recommended)
+    // When both installCRDs and crds.enabled are specified, crds.enabled takes precedence
     // installCRDs: true,
 
     helmOptions: {
@@ -79,6 +80,7 @@ cm = certmanager.CertManager("cert-manager-deployment",
     },
 
     # Option 2: Using deprecated option (not recommended)
+    # When both install_crds and crds.enabled are specified, crds.enabled takes precedence
     # install_crds=True,
 
     helm_options={
@@ -122,6 +124,7 @@ func main() {
 			},
 
 			// Option 2: Using deprecated option (not recommended)
+			// When both InstallCRDs and Crds.Enabled are specified, Crds.Enabled takes precedence
 			// InstallCRDs: pulumi.BoolPtr(enabled),
 
 			HelmOptions: &helmv3.ReleaseArgs{
@@ -145,4 +148,4 @@ if you need to override them, you may do so using the `helmOptions` parameter. R
 [the API docs for the `kubernetes:helm/v3:Release` Pulumi type](
 https://www.pulumi.com/docs/reference/pkg/kubernetes/helm/v3/release/#inputs) for a full set of choices.
 
-For complete details, refer to the Pulumi Package details within the Pulumi Registry.
+For complete details, refer to the Pulumi Package details within the Pulumi Registry.

provider/cmd/pulumi-resource-kubernetes-cert-manager/schema.json

@@ -90,7 +90,7 @@
                 },
                 "installCRDs": {
                     "type": "boolean",
-                    "description": "⚠️ Deprecated: Use crds.enabled instead."
+                    "description": "⚠️ Deprecated: Use crds.enabled instead. When both installCRDs and crds.enabled are specified, crds.enabled takes precedence."
                 },
                 "crds": {
                     "$ref": "#/types/kubernetes-cert-manager:index:CertManagerCrds",

provider/pkg/provider/chart.go

@@ -37,6 +37,8 @@ func (c *CertManager) DefaultRepoURL() string                    { return "https
 // CertManager contains the set of arguments for creating a CertManager component resource.
 type CertManagerArgs struct {
 	Global       kcm.CertManagerGlobalPtrInput `pulumi:"global"`
+	// Deprecated: Use crds.enabled instead. 
+	// When both installCRDs and crds.enabled are specified, crds.enabled takes precedence.
 	InstallCRDs  *bool                         `pulumi:"installCRDs"`
 	Crds         kcm.CertManagerCrdsPtrInput   `pulumi:"crds"`
 	ReplicaCount *int                          `pulumi:"replicaCount"`