fix: document describe cluster gaps and sasl casing

Author: DCjanus

admin.go

@@ -376,6 +376,10 @@ func (ca *clusterAdmin) describeClusterUsingMetadata() (brokers []*Broker, contr
 }
 
 func convertDescribeClusterBrokers(entries []*DescribeClusterBroker) []*Broker {
+	// TODO: DescribeCluster brokers currently drop DescribeCluster-specific fields
+	// such as IsFenced (KIP-1073) and ClusterAuthorizedOperations because Broker
+	// has no equivalents yet. This keeps API parity with MetadataResponse for now,
+	// but the richer fields need to be surfaced in a future change.
 	if len(entries) == 0 {
 		return nil
 	}

examples/describe_cluster/main.go

@@ -122,7 +122,7 @@ func configureSASL(config *sarama.Config) error {
 	config.Net.SASL.AuthIdentity = *saslAuthzID
 
 	switch mech {
-	case "PLAIN", "PLAINtext":
+	case "PLAIN", "PLAINTEXT":
 		config.Net.SASL.Mechanism = sarama.SASLTypePlaintext
 	case "SCRAM-SHA-256":
 		config.Net.SASL.Mechanism = sarama.SASLTypeSCRAMSHA256