S1008: allow either branch to be documented

Updates: gh-704
Updates: gh-1488

Author: dominikh

simple/s1008/s1008.go

@@ -107,8 +107,8 @@ func run(pass *analysis.Pass) (any, error) {
 			return false
 		}
 
-		// Don't flag if both are commented.
-		if hasComments(n1) && hasComments(n2) {
+		// Don't flag if either branch is commented
+		if hasComments(n1) || hasComments(n2) {
 			return
 		}
 

simple/s1008/testdata/go1.0/CheckIfReturn/comment.go

@@ -32,14 +32,14 @@ func cmt4(x string) bool {
 }
 
 func cmt5(x string) bool {
-	if len(x) > 0 { //@ diag(`should use 'return len(x) == 0'`)
+	if len(x) > 0 {
 		return false
 	}
 	return true // A
 }
 
 func cmt6(x string) bool {
-	if len(x) > 0 { //@ diag(`should use 'return len(x) == 0'`)
+	if len(x) > 0 {
 		return false // A
 	}
 	return true