Add some function comments

Author: bjee19

internal/controller/state/graph/policies.go

@@ -325,18 +325,12 @@ func checkTargetRoutesForOverlap(
 func checkForRouteOverlap(route *L7Route, hostPortPaths map[string]string) *conditions.Condition {
 	for _, parentRef := range route.ParentRefs {
 		if parentRef.Attachment != nil {
-			// fmt.Printf("This is the parentRef attachment: %#v\n", parentRef.Attachment)
 			port := parentRef.Attachment.ListenerPort
 			for _, hostname := range parentRef.Attachment.AcceptedHostnames {
-				// fmt.Println("Here is the keyName: " + keyName)
-				// fmt.Printf("This is the parentref hostnames: %v\n", hostname)
 				for _, rule := range route.Spec.Rules {
-					// fmt.Printf("This is the routeRule: %v\n", rule)
 					for _, match := range rule.Matches {
-						// fmt.Printf("This is the match: %v\n", match)
 						if match.Path != nil && match.Path.Value != nil {
 							key := fmt.Sprintf("%s:%d%s", hostname, port, *match.Path.Value)
-							// fmt.Println("This is the key: " + key)
 							if val, ok := hostPortPaths[key]; !ok {
 								hostPortPaths[key] = fmt.Sprintf("%s/%s", route.Source.GetNamespace(), route.Source.GetName())
 							} else {

internal/controller/status/prepare_requests.go

@@ -95,6 +95,8 @@ func PrepareRouteRequests(
 	return reqs
 }
 
+// removeDuplicateIndexParentRefs removes duplicate ParentRefs by Idx, keeping the first occurrence.
+// If an Idx is duplicated, the SectionName for the stored ParentRef is nil.
 func removeDuplicateIndexParentRefs(parentRefs []graph.ParentRef) []graph.ParentRef {
 	idxCount := make(map[int]int)
 	for _, ref := range parentRefs {
@@ -129,6 +131,10 @@ func prepareRouteStatus(
 	transitionTime metav1.Time,
 	srcGeneration int64,
 ) v1.RouteStatus {
+	// If a route did not specify a sectionName in its parentRefs section, it will attempt to attach to all available
+	// listeners. In this case, parentRefs will be created and attached to the route for each attachable listener.
+	// These parentRefs will all have the same Idx, and in order to not duplicate route statuses for the same Gateway,
+	// we need to remove these duplicates. Additionally, we remove the sectionName.
 	processedParentRefs := removeDuplicateIndexParentRefs(parentRefs)
 
 	parents := make([]v1.RouteParentStatus, 0, len(processedParentRefs))