From dccd791e31b6dfd67a66f68da0a36a5ee34ef5d6 Mon Sep 17 00:00:00 2001
From: Camila Macedo <camilamacedo86@gmail.com>
Date: Mon, 20 Feb 2023 23:00:33 +0000
Subject: [PATCH 1/3] :warning: deprecate go/v3

---
 docs/book/src/plugins/go-v3-plugin.md | 17 +++++++++++++++--
 pkg/plugins/golang/v4/plugin.go       |  7 +++++++
 2 files changed, 22 insertions(+), 2 deletions(-)

diff --git a/docs/book/src/plugins/go-v3-plugin.md b/docs/book/src/plugins/go-v3-plugin.md
index 54e9da430f5..21613773f7f 100644
--- a/docs/book/src/plugins/go-v3-plugin.md
+++ b/docs/book/src/plugins/go-v3-plugin.md
@@ -1,4 +1,16 @@
-# go/v3 (go.kubebuilder.io/v3)
+# [Deprecated] go/v3 (go.kubebuilder.io/v3)
+
+<aside class="note warning">
+<h1>Deprecated</h1>
+
+The `go/v3` cannot fully support Kubernetes 1.25+ and work with Kustomize versions > v3.
+
+The recommended way to migrate a `v3` project is to create a new `v4` project and copy over the API
+and the reconciliation code. The conversion will end up with a project that looks like a native `v4` project.
+For further information check the [Migration guide](../migration/migration_guide_gov3_to_gov4.md)
+
+</aside>
+
 
 Kubebuilder tool will scaffold the go/v3 plugin by default. This plugin is a composition of the plugins ` kustomize.common.kubebuilder.io/v1` and `base.go.kubebuilder.io/v3`. By using you can scaffold the default project which is a helper to construct sets of [controllers][controller-runtime]. 
 
@@ -23,8 +35,9 @@ As `go/v3` is the default plugin there is no need to explicitly mention to Kubeb
 To create a new project with the `go/v3` plugin the following command can be used:
 
 ```sh
-kubebuilder init --domain tutorial.kubebuilder.io --repo tutorial.kubebuilder.io/project
+kubebuilder init --plugins=`go/v3` --domain tutorial.kubebuilder.io --repo tutorial.kubebuilder.io/project
 ```
+
 All the other subcommands supported by the go/v3 plugin can be executed similarly.
 
 <aside class="note">
diff --git a/pkg/plugins/golang/v4/plugin.go b/pkg/plugins/golang/v4/plugin.go
index 03a604143ba..b13b6d75227 100644
--- a/pkg/plugins/golang/v4/plugin.go
+++ b/pkg/plugins/golang/v4/plugin.go
@@ -63,3 +63,10 @@ func (p Plugin) GetCreateWebhookSubcommand() plugin.CreateWebhookSubcommand {
 
 // GetEditSubcommand will return the subcommand which is responsible for editing the scaffold of the project
 func (p Plugin) GetEditSubcommand() plugin.EditSubcommand { return &p.editSubcommand }
+
+func (p Plugin) DeprecationWarning() string {
+	return "This version is deprecated." +
+		"The `go/v3` cannot scaffold projects using kustomize versions v4x+ and cannot be fulled support on Kubernetes 1.25+." +
+		"It is recommended to upgrade your project to the latest versions available (go/v4)." +
+		"Please, check the migration guide to learn how to upgrade your project"
+}

From 9830f50173d9928c5efd24fac61b0db54e07b02e Mon Sep 17 00:00:00 2001
From: Camila Macedo <7708031+camilamacedo86@users.noreply.github.com>
Date: Tue, 21 Feb 2023 08:51:52 +0000
Subject: [PATCH 2/3] Apply suggestions from code review

---
 pkg/plugins/golang/v4/plugin.go | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/pkg/plugins/golang/v4/plugin.go b/pkg/plugins/golang/v4/plugin.go
index b13b6d75227..b1951d4837a 100644
--- a/pkg/plugins/golang/v4/plugin.go
+++ b/pkg/plugins/golang/v4/plugin.go
@@ -66,7 +66,8 @@ func (p Plugin) GetEditSubcommand() plugin.EditSubcommand { return &p.editSubcom
 
 func (p Plugin) DeprecationWarning() string {
 	return "This version is deprecated." +
-		"The `go/v3` cannot scaffold projects using kustomize versions v4x+ and cannot be fulled support on Kubernetes 1.25+." +
+		"The `go/v3` cannot scaffold projects using kustomize versions v4x+" +
+		" and cannot be whole support on Kubernetes 1.25+." +
 		"It is recommended to upgrade your project to the latest versions available (go/v4)." +
 		"Please, check the migration guide to learn how to upgrade your project"
 }

From 5de0c2a31fe5e548c4c2309917a74462f599b7fa Mon Sep 17 00:00:00 2001
From: Camila Macedo <7708031+camilamacedo86@users.noreply.github.com>
Date: Mon, 6 Mar 2023 09:10:11 +0000
Subject: [PATCH 3/3] Update pkg/plugins/golang/v4/plugin.go

Co-authored-by: Bryce Palmer <everettraven@gmail.com>
---
 pkg/plugins/golang/v4/plugin.go | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pkg/plugins/golang/v4/plugin.go b/pkg/plugins/golang/v4/plugin.go
index b1951d4837a..89596a2a11c 100644
--- a/pkg/plugins/golang/v4/plugin.go
+++ b/pkg/plugins/golang/v4/plugin.go
@@ -67,7 +67,7 @@ func (p Plugin) GetEditSubcommand() plugin.EditSubcommand { return &p.editSubcom
 func (p Plugin) DeprecationWarning() string {
 	return "This version is deprecated." +
 		"The `go/v3` cannot scaffold projects using kustomize versions v4x+" +
-		" and cannot be whole support on Kubernetes 1.25+." +
+		" and cannot fully support Kubernetes 1.25+." +
 		"It is recommended to upgrade your project to the latest versions available (go/v4)." +
 		"Please, check the migration guide to learn how to upgrade your project"
 }