Cleaning up godocs after v0.5.0 API Review

apis/v1alpha2/httproute_types.go

@@ -244,7 +244,7 @@ const (
 	// path element refers to the list of labels in the path split by
 	// the `/` separator. When specified, a trailing `/` is ignored.
 	//
-	// For example. the paths `/abc`, `/abc/`, and `/abc/def` would all match
+	// For example, the paths `/abc`, `/abc/`, and `/abc/def` would all match
 	// the prefix `/abc`, but the path `/abcd` would not.
 	//
 	// "PathPrefix" is semantically equivalent to the "Prefix" path type in the
@@ -734,7 +734,7 @@ type HTTPPathModifier struct {
 }
 
 // HTTPRequestRedirect defines a filter that redirects a request. This filter
-// MUST not be used on the same Route rule as a HTTPURLRewrite filter.
+// MUST NOT be used on the same Route rule as a HTTPURLRewrite filter.
 type HTTPRequestRedirectFilter struct {
 	// Scheme is the scheme to be used in the value of the `Location`
 	// header in the response.
@@ -786,7 +786,7 @@ type HTTPRequestRedirectFilter struct {
 
 // HTTPURLRewriteFilter defines a filter that modifies a request during
 // forwarding. At most one of these filters may be used on a Route rule. This
-// may not be used on the same Route rule as a HTTPRequestRedirect filter.
+// MUST NOT be used on the same Route rule as a HTTPRequestRedirect filter.
 //
 // <gateway:experimental>
 // Support: Extended

apis/v1alpha2/shared_types.go

@@ -84,15 +84,15 @@ type ParentReference struct {
 	SectionName *SectionName `json:"sectionName,omitempty"`
 
 	// Port is the network port this Route targets. It can be interpreted
-	// differently based on the type of parent resource:
-	//
-	// * Gateway: All listeners listening on the specified port that also
-	// support this kind of Route(and select this Route). It's not
-	// recommended to set `Port` unless the networking behaviors specified
-	// in a Route must apply to a specific port as opposed to a listener(s)
-	// whose port(s) may be changed. When both Port and SectionName are
-	// specified, the name and port of the selected listener must match both
-	// specified values.
+	// differently based on the type of parent resource.
+	//
+	// When the parent resource is a Gateway, this targets all listeners
+	// listening on the specified port that also support this kind of Route(and
+	// select this Route). It's not recommended to set `Port` unless the
+	// networking behaviors specified in a Route must apply to a specific port
+	// as opposed to a listener(s) whose port(s) may be changed. When both Port
+	// and SectionName are specified, the name and port of the selected listener
+	// must match both specified values.
 	//
 	// Implementations MAY choose to support other parent resources.
 	// Implementations supporting other types of parent resources MUST clearly