diff --git a/CHANGELOG.md b/CHANGELOG.md
index f262016a8..06cdd5f63 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,3 +1,9 @@
+## 3.0.0-pre1 (Jan 16, 2025)
+
+* This pre-release migrates ports the provider project from `terraform-plugin-sdk/v2` to `terraform-plugin-framework` [[GH-1379](https://github.com/hashicorp/terraform-provider-helm/pull/1379)]
+
+Please refer to the [migration guide](./docs/guides/v3-upgrade-guide.md).
+
 ## 2.17.0 (Dec 19, 2024)
 
 ENHANCEMENT:
diff --git a/README.md b/README.md
index ef0b3a9de..82c1dae95 100644
--- a/README.md
+++ b/README.md
@@ -32,7 +32,7 @@ information.
 
 ```hcl
 provider "helm" {
-  kubernetes {
+  kubernetes = {
     config_path = "~/.kube/config"
   }
 }
@@ -40,13 +40,15 @@ provider "helm" {
 resource "helm_release" "nginx_ingress" {
   name       = "nginx-ingress-controller"
 
-  repository = "https://charts.bitnami.com/bitnami"
+  repository = "oci://registry-1.docker.io/bitnamicharts"
   chart      = "nginx-ingress-controller"
 
-  set {
+  set = [
+    {
     name  = "service.type"
     value = "ClusterIP"
-  }
+    }
+  ]
 }
 ```