From e83c9d73164ad2a25b87a0c9f95d41d6ac862ccb Mon Sep 17 00:00:00 2001
From: Camila Macedo <cmacedo@redhat.com>
Date: Thu, 16 Jun 2022 07:50:41 +0100
Subject: [PATCH 1/2] :warning: officially deprecate go/v2 plugin

Co-authored-by: Bryce Palmer <everettraven@gmail.com>
---
 docs/book/src/SUMMARY.md                   |  2 +-
 docs/book/src/plugins/available-plugins.md |  6 ++---
 docs/book/src/plugins/go-v2-plugin.md      | 27 ++++++++++++++++++----
 pkg/config/v2/config.go                    |  1 +
 pkg/config/v2/config_test.go               |  1 +
 pkg/plugins/golang/v2/api.go               |  1 +
 pkg/plugins/golang/v2/edit.go              |  1 +
 pkg/plugins/golang/v2/init.go              |  1 +
 pkg/plugins/golang/v2/plugin.go            | 10 ++++++++
 pkg/plugins/golang/v2/webhook.go           |  1 +
 test/e2e/v2/e2e_suite_test.go              |  1 +
 test/e2e/v2/plugin_cluster_test.go         |  1 +
 test/e2e/v3/plugin_cluster_test.go         |  2 ++
 13 files changed, 47 insertions(+), 8 deletions(-)

diff --git a/docs/book/src/SUMMARY.md b/docs/book/src/SUMMARY.md
index 5ddc0ec37d7..b22a120a3f9 100644
--- a/docs/book/src/SUMMARY.md
+++ b/docs/book/src/SUMMARY.md
@@ -109,8 +109,8 @@
   - [Extending the CLI](./plugins/extending-cli.md)
   - [Creating your own plugins](./plugins/creating-plugins.md)
   - [Available Plugins](./plugins/available-plugins.md)
+    - [go/v2 plugin (Deprecated)](./plugins/go-v2-plugin.md)
     - [go/v3 plugin](./plugins/go-v3-plugin.md)
-    - [go/v2 plugin](./plugins/go-v2-plugin.md)
     - [Declarative V1](./plugins/declarative-v1.md)
     - [Kustomize V1](./plugins/kustomize-v1.md)
   - [Plugins Versioning](./plugins/plugins-versioning.md)
diff --git a/docs/book/src/plugins/available-plugins.md b/docs/book/src/plugins/available-plugins.md
index 213be4d8adf..b4eef9f55ab 100644
--- a/docs/book/src/plugins/available-plugins.md
+++ b/docs/book/src/plugins/available-plugins.md
@@ -4,11 +4,11 @@ This section describes the plugins supported and shipped in with the Kubebuilder
 
 | Plugin   | Key | Description | 
 |---|---|---|
-| [go.kubebuilder.io/v3](go-v3-plugin.md)  | `go/v3` | Default scaffold to create the projects when none plugin(s) are informed. Responsible for scaffold the Golang project and its configurations. |
-| [go.kubebuilder.io/v2](go-v2-plugin.md)    | `go/v2` | Golang plugin responsible for scaffold the legacy layout provided with Kubebuilder CLI >= `2.0.0` and < `3.0.0`.  |
+| [go.kubebuilder.io/v2 - (Deprecated)](go-v2-plugin.md)    | `go/v2` | Golang plugin responsible for scaffolding the legacy layout provided with Kubebuilder CLI >= `2.0.0` and < `3.0.0`.  |
+| [go.kubebuilder.io/v3 - (Default scaffold with Kubebuilder init)](go-v3-plugin.md)  | `go/v3` | Default scaffold to create the projects when none plugin(s) are informed. Responsible for scaffold the Golang project and its configurations. |
 | [declarative.go.kubebuilder.io/v1](declarative-v1.md)  | `declarative/v1`  | Optional plugin used to scaffold APIs/controllers using the [kubebuilder-declarative-pattern][kubebuilder-declarative-pattern] project. |
 | [kustomize.common.kubebuilder.io/v1](kustomize-v1.md)  | `kustomize/v1`  | Responsible for scaffold all manifests to configure the projects with [kustomize(v3)][kustomize]. (create and update the the `config/` directory). This plugin is used in the composition to create the plugin (`go/v3`). |
-| [kustomize.common.kubebuilder.io/v1](kustomize-v2-alpha.md)  | `kustomize/v2-alpha`  | It has the same purpose of  `kustomize/v1`. However, it works with [kustomize][kustomize] version `v4` and address the required changes for the future kustomize configurations. It will probably be used with the future `go/v4-alpha` plugin. |
+| [kustomize.common.kubebuilder.io/v2-alpha](kustomize-v2-alpha.md)  | `kustomize/v2-alpha`  | It has the same purpose of  `kustomize/v1`. However, it works with [kustomize][kustomize] version `v4` and addresses the required changes for future kustomize configurations. It will probably be used with the future `go/v4-alpha` plugin. |
 | `base.go.kubebuilder.io/v3`  | `base/v3` | Responsible for scaffold all files which specific requires Golang. This plugin is used in the composition to create the plugin (`go/v3`) |
 
 <aside class="note">
diff --git a/docs/book/src/plugins/go-v2-plugin.md b/docs/book/src/plugins/go-v2-plugin.md
index 152f1e237d9..aea3b38db13 100644
--- a/docs/book/src/plugins/go-v2-plugin.md
+++ b/docs/book/src/plugins/go-v2-plugin.md
@@ -1,12 +1,31 @@
-# go/v2 (go.kubebuilder.io/v2)
+# [Deprecated] go/v2 (go.kubebuilder.io/v2 - "Kubebuilder 2.x" layout)
 
-The `go/v2` plugin has the purpose to scaffold Golang projects to help users to build projects with [controllers][controller-runtime] and keep the backwards compatibility with the default scaffold made using Kubebuilder CLI `2.x.z` releases.   
+<aside class="note warning">
+<h1>Deprecated</h1>
+
+The `go/v2` plugin cannot scaffold projects in which CRDs and/or Webhooks have a `v1` API version. 
+The `go/v2` plugin scaffolds with the `v1beta1` API version which was deprecated in Kubernetes `1.16` and removed in `1.22`. 
+This plugin was kept to ensure backwards compatibility with projects that were scaffolded with the old `"Kubebuilder 2.x"` layout and does not work with the new plugin ecosystem that was introduced with Kubebuilder `3.0.0` [More info](plugins.md)
+
+Since `28 Apr 2021`, the default layout produced by Kubebuilder changed and is done via the `go/v3`. 
+We encourage you migrate your project to the latest version if your project was built with a Kubebuilder
+versions < `3.0.0`. 
 
-<node>
+The recommended way to migrate a `v2` project is to create a new `v3` project and copy over the API 
+and the reconciliation code. The conversion will end up with a project that looks like a native `v3` project.
+For further information check the [Migration guide](./../migration/manually_migration_guide_v2_v3.md)
+
+</aside>
+
+The `go/v2` plugin has the purpose to scaffold Golang projects to help users 
+to build projects with [controllers][controller-runtime] and keep the backwards compatibility 
+with the default scaffold made using Kubebuilder CLI `2.x.z` releases.
+
+<aside class="note">
 
 You can check samples using this plugin by looking at the `project-v2-<options>` directories under the [testdata][testdata] projects on the root directory of the Kubebuilder project.
 
-</node>  
+</aside>
 
 ## When should I use this plugin ?
 
diff --git a/pkg/config/v2/config.go b/pkg/config/v2/config.go
index 709105ab956..f00e5fa643d 100644
--- a/pkg/config/v2/config.go
+++ b/pkg/config/v2/config.go
@@ -14,6 +14,7 @@ See the License for the specific language governing permissions and
 limitations under the License.
 */
 
+//go:deprecated This package has been deprecated
 package v2
 
 import (
diff --git a/pkg/config/v2/config_test.go b/pkg/config/v2/config_test.go
index e610da95820..9d36e042f88 100644
--- a/pkg/config/v2/config_test.go
+++ b/pkg/config/v2/config_test.go
@@ -14,6 +14,7 @@ See the License for the specific language governing permissions and
 limitations under the License.
 */
 
+//go:deprecated This package has been deprecated
 package v2
 
 import (
diff --git a/pkg/plugins/golang/v2/api.go b/pkg/plugins/golang/v2/api.go
index 35676e788e6..88ccd3d188b 100644
--- a/pkg/plugins/golang/v2/api.go
+++ b/pkg/plugins/golang/v2/api.go
@@ -14,6 +14,7 @@ See the License for the specific language governing permissions and
 limitations under the License.
 */
 
+//go:deprecated This package has been deprecated
 package v2
 
 import (
diff --git a/pkg/plugins/golang/v2/edit.go b/pkg/plugins/golang/v2/edit.go
index bdab9054400..d8e04f39443 100644
--- a/pkg/plugins/golang/v2/edit.go
+++ b/pkg/plugins/golang/v2/edit.go
@@ -14,6 +14,7 @@ See the License for the specific language governing permissions and
 limitations under the License.
 */
 
+//go:deprecated This package has been deprecated
 package v2
 
 import (
diff --git a/pkg/plugins/golang/v2/init.go b/pkg/plugins/golang/v2/init.go
index 7b85d023c5a..bafe378c359 100644
--- a/pkg/plugins/golang/v2/init.go
+++ b/pkg/plugins/golang/v2/init.go
@@ -14,6 +14,7 @@ See the License for the specific language governing permissions and
 limitations under the License.
 */
 
+//go:deprecated This package has been deprecated
 package v2
 
 import (
diff --git a/pkg/plugins/golang/v2/plugin.go b/pkg/plugins/golang/v2/plugin.go
index fd1d7779416..894a660dd1f 100644
--- a/pkg/plugins/golang/v2/plugin.go
+++ b/pkg/plugins/golang/v2/plugin.go
@@ -14,6 +14,7 @@ See the License for the specific language governing permissions and
 limitations under the License.
 */
 
+//go:deprecated This package has been deprecated
 package v2
 
 import (
@@ -63,3 +64,12 @@ 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 and is no longer scaffolded by default since `28 Apr 2021`." +
+		"The `go/v2` plugin cannot scaffold projects in which CRDs and/or Webhooks have a `v1` API version." +
+		"Be aware that v1beta1 API for CRDs and Webhooks was deprecated on Kubernetes 1.16 and are" +
+		"removed as of the Kubernetes 1.22 release. Therefore, since this plugin cannot produce projects that" +
+		"work on Kubernetes versions >= 1.22, it is recommended to upgrade your project " +
+		"to the latest versions available."
+}
diff --git a/pkg/plugins/golang/v2/webhook.go b/pkg/plugins/golang/v2/webhook.go
index d142298850b..02a7ae91eab 100644
--- a/pkg/plugins/golang/v2/webhook.go
+++ b/pkg/plugins/golang/v2/webhook.go
@@ -14,6 +14,7 @@ See the License for the specific language governing permissions and
 limitations under the License.
 */
 
+//go:deprecated This package has been deprecated
 package v2
 
 import (
diff --git a/test/e2e/v2/e2e_suite_test.go b/test/e2e/v2/e2e_suite_test.go
index fbddd1cb86f..85dfdad1c71 100644
--- a/test/e2e/v2/e2e_suite_test.go
+++ b/test/e2e/v2/e2e_suite_test.go
@@ -14,6 +14,7 @@ See the License for the specific language governing permissions and
 limitations under the License.
 */
 
+//go:deprecated This package has been deprecated
 package v2
 
 import (
diff --git a/test/e2e/v2/plugin_cluster_test.go b/test/e2e/v2/plugin_cluster_test.go
index 5fd38e871cd..4e6648c2f5f 100644
--- a/test/e2e/v2/plugin_cluster_test.go
+++ b/test/e2e/v2/plugin_cluster_test.go
@@ -14,6 +14,7 @@ See the License for the specific language governing permissions and
 limitations under the License.
 */
 
+//go:deprecated This package has been deprecated
 package v2
 
 import (
diff --git a/test/e2e/v3/plugin_cluster_test.go b/test/e2e/v3/plugin_cluster_test.go
index 5af2ed93584..85ff1778c5b 100644
--- a/test/e2e/v3/plugin_cluster_test.go
+++ b/test/e2e/v3/plugin_cluster_test.go
@@ -77,6 +77,8 @@ var _ = Describe("kubebuilder", func() {
 			kbc.Destroy()
 		})
 
+		//TODO: remove me when the plugin go/v2 be removed
+		//go:deprecated this plugin is deprecated
 		Context("plugin go.kubebuilder.io/v2", func() {
 			// Use cert-manager with v1beta2 CRs.
 			BeforeEach(func() {

From 6765fcfc11cd9550b5e4f6b8fb433b1ef29d085f Mon Sep 17 00:00:00 2001
From: Camila Macedo <7708031+camilamacedo86@users.noreply.github.com>
Date: Tue, 21 Jun 2022 15:54:27 +0100
Subject: [PATCH 2/2] Update docs/book/src/plugins/available-plugins.md

Co-authored-by: Bryce Palmer <everettraven@gmail.com>
---
 docs/book/src/plugins/available-plugins.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/book/src/plugins/available-plugins.md b/docs/book/src/plugins/available-plugins.md
index b4eef9f55ab..a535f31fe8a 100644
--- a/docs/book/src/plugins/available-plugins.md
+++ b/docs/book/src/plugins/available-plugins.md
@@ -5,7 +5,7 @@ This section describes the plugins supported and shipped in with the Kubebuilder
 | Plugin   | Key | Description | 
 |---|---|---|
 | [go.kubebuilder.io/v2 - (Deprecated)](go-v2-plugin.md)    | `go/v2` | Golang plugin responsible for scaffolding the legacy layout provided with Kubebuilder CLI >= `2.0.0` and < `3.0.0`.  |
-| [go.kubebuilder.io/v3 - (Default scaffold with Kubebuilder init)](go-v3-plugin.md)  | `go/v3` | Default scaffold to create the projects when none plugin(s) are informed. Responsible for scaffold the Golang project and its configurations. |
+| [go.kubebuilder.io/v3 - (Default scaffold with Kubebuilder init)](go-v3-plugin.md)  | `go/v3` | Default scaffold used for creating a project when no plugin(s) are provided. Responsible for scaffolding Golang projects and its configurations. |
 | [declarative.go.kubebuilder.io/v1](declarative-v1.md)  | `declarative/v1`  | Optional plugin used to scaffold APIs/controllers using the [kubebuilder-declarative-pattern][kubebuilder-declarative-pattern] project. |
 | [kustomize.common.kubebuilder.io/v1](kustomize-v1.md)  | `kustomize/v1`  | Responsible for scaffold all manifests to configure the projects with [kustomize(v3)][kustomize]. (create and update the the `config/` directory). This plugin is used in the composition to create the plugin (`go/v3`). |
 | [kustomize.common.kubebuilder.io/v2-alpha](kustomize-v2-alpha.md)  | `kustomize/v2-alpha`  | It has the same purpose of  `kustomize/v1`. However, it works with [kustomize][kustomize] version `v4` and addresses the required changes for future kustomize configurations. It will probably be used with the future `go/v4-alpha` plugin. |