Review updates

Signed-off-by: Andrew Stoycos <[email protected]>

Author: astoycos

RELEASE.md

@@ -4,7 +4,7 @@
 
 The Network Policy API project is has the following two main release components:
 - Kubernetes Custom Resource Definitions (CRDs)
-- Corresponding Go API in the form of `sigs.k8s.io/network-policy-api` Go package
+- Corresponding Go bindings for the API (`sigs.k8s.io/network-policy-api` Go package)
 
 This repository is the home for both of the above components.
 
@@ -14,6 +14,8 @@ documentation].
 
 [the release documentation]: site-src/versioning.md
 
+Adapted with :blue_heart: from the [gateway api project release documentation](https://gateway-api.sigs.k8s.io/)
+
 ## Releasing a new version
 
 ### Writing a Changelog

apis/v1alpha1/adminnetworkpolicy_types.go

@@ -31,7 +31,6 @@ import (
 // +kubebuilder:printcolumn:name="Priority",type=string,JSONPath=".spec.priority"
 // +kubebuilder:printcolumn:name="Age",type="date",JSONPath=".metadata.creationTimestamp"
 // +k8s:deepcopy-gen:interfaces=k8s.io/apimachinery/pkg/runtime.Object
-// +kubebuilder:metadata:annotations="api-approved.kubernetes.io=https://github.com/kubernetes/enhancements/pull/2522"
 // AdminNetworkPolicy is  a cluster level resource that is part of the
 // AdminNetworkPolicy API.
 type AdminNetworkPolicy struct {

apis/v1alpha1/baselineadminnetworkpolicy_types.go

@@ -26,7 +26,6 @@ import (
 // +kubebuilder:resource:shortName=banp,scope=Cluster
 // +kubebuilder:printcolumn:name="Age",type="date",JSONPath=".metadata.creationTimestamp"
 // +k8s:deepcopy-gen:interfaces=k8s.io/apimachinery/pkg/runtime.Object
-// +kubebuilder:metadata:annotations="api-approved.kubernetes.io=https://github.com/kubernetes/enhancements/pull/2522"
 // +kubebuilder:validation:XValidation:rule="self.metadata.name == 'default'",message="Only one baseline admin network policy with metadata.name=\"default\" can be created in the cluster"
 // BaselineAdminNetworkPolicy is a cluster level resource that is part of the
 // AdminNetworkPolicy API.

site-src/api-overview.md

@@ -1,6 +1,6 @@
 # Api Object Overview
 
-Prior to the Network Policy API the original NetworkPolicy Resource was the only
+Prior to the Network Policy API the original NetworkPolicy V1 Resource was the only
 way for k8s users to apply security rules to their kubernetes workloads. One of the
 main drawbacks to this API was that it was designed exclusively for use by the
 Application Developer, although in reality it is used by many different cluster
@@ -9,8 +9,8 @@ Contrast, each resource in the Network Policy API is designed to be used by a
 specific persona.
 
 With the advent of the AdminNetworkPolicy and BaselineAdminNetworkPolicy
-resources Cluster Admins will now have the ability to apply policy on in-cluster
-workloads with only a few simple policy objects that can be applied globally.
+resources Cluster Admins will now have the ability to apply policy globally with
+only a few simple policy objects.
 
 ## Roles and personas
 

site-src/implementations.md

@@ -10,7 +10,7 @@ implementations, the versions they cover, and documentation to help users get st
 
 Updated: 05-08-2023
 
-- [Ovn-Kubernetes CNI](https://github.com/ovn-org/ovn-kubernetes/pull/3489) (work in progress)
+- [OVN-Kubernetes CNI](https://github.com/ovn-org/ovn-kubernetes/pull/3489) (work in progress)
 - [Antrea CNI](https://github.com/antrea-io/antrea/pull/4537) (work in progress)
 - [Cilium CNI](https://github.com/cilium/cilium/issues/23380) (tracking issue)
 - [Calico CNI](https://github.com/projectcalico/calico/issues/7578) (tracking issue)