docs(zone): add a comment about normalizeZoneName
@@ -849,6 +849,12 @@ func (api *API) UpdateFallbackOrigin(ctx context.Context, zoneID string, fbo Fal
// as Punycode, or converting fails (for invalid representations), it
// is returned unchanged.
//
+// Because all the zone name comparison is currently done on the server side
+// (except for comparison with the empty string), theoretically, we could
+// remove this function and let the server decide equivalence between zone
+// names. However, there should be no harm calling this function other than
+// potential performance penality.
+//
// Note: conversion errors are silently discarded.
func normalizeZoneName(name string) string {
if n, err := idna.ToUnicode(name); err == nil {
