Deprecate obsolete errors pkg

The /errors package has its origin in when capi providers were machineActuators that needed to vendor core capi to function.
There's no usage recommendations and value is questionable since we moved to CRDs and conditions for interoperability between core and providers.
I think we should deprecate it and if there's any use case relying on it we should support it via conditions

Author: enxebre

docs/book/src/developer/providers/migrations/v1.7-to-v1.8.md

@@ -27,3 +27,4 @@ maintainers of providers and consumers of our Go API.
 - It's highly recommended to move to a new setup-envtest version that uses envtest binaries from controller-tools releases
   instead of the deprecated GCS bucket. More details can be found in [#10569](https://github.com/kubernetes-sigs/cluster-api/pull/10569)
   and [kubernetes-sigs/controller-runtime#2811](https://github.com/kubernetes-sigs/controller-runtime/pull/2811).
+- The Errors package [has been deprecated in v1.8](https://github.com/kubernetes-sigs/cluster-api/issues/10784). It's recommented to remove any usage of the currently exported variables.

errors/clusters.go

@@ -14,6 +14,7 @@ See the License for the specific language governing permissions and
 limitations under the License.
 */
 
+// Deprecated: This package will be removed in one of the next releases.
 package errors
 
 import (

errors/consts.go

@@ -14,6 +14,7 @@ See the License for the specific language governing permissions and
 limitations under the License.
 */
 
+// Deprecated: This package will be removed in one of the next releases.
 package errors
 
 // MachineStatusError defines errors states for Machine objects.

errors/doc.go

@@ -15,4 +15,6 @@ limitations under the License.
 */
 
 // Package errors makes a set of error message handlers available for use by Cluster API Providers.
+//
+// Deprecated: This package will be removed in one of the next releases.
 package errors

errors/kubeadmcontrolplane.go

@@ -14,6 +14,7 @@ See the License for the specific language governing permissions and
 limitations under the License.
 */
 
+// Deprecated: This package will be removed in one of the next releases.
 package errors
 
 // KubeadmControlPlaneError is a more descriptive kind of error that represents an error condition that

errors/machines.go

@@ -14,6 +14,7 @@ See the License for the specific language governing permissions and
 limitations under the License.
 */
 
+// Deprecated: This package will be removed in one of the next releases.
 package errors
 
 import (

errors/pointer.go

@@ -14,6 +14,7 @@ See the License for the specific language governing permissions and
 limitations under the License.
 */
 
+// Deprecated: This package will be removed in one of the next releases.
 package errors
 
 // MachineStatusErrorPtr converts a MachineStatusError to a pointer.