Improve code freeze build code util method comments

Author: iangmaia

fastlane/Fastfile

@@ -1429,15 +1429,15 @@ def build_code_current
   BUILD_CODE_FORMATTER.build_code(version: version)
 end
 
-# Returns the build code of the app for the code freeze. It is the release version name plus sets the build number to 0
+# Returns the initial build code for a code freeze (e.g., "1.2.3.0" for release version "1.2.3")
+# Takes the release version and formats it as a four-part build code with the build number set to 0
 #
 def build_code_code_freeze(version_short: nil)
+  # Use provided version or read the current release version from the .xcconfig file
   version_short ||= VERSION_FILE.read_release_version
-  # Read the current build code from the .xcconfig file and parse it into an AppVersion object
-  # The AppVersion is used because WCiOS uses the four part (1.2.3.4) build code format, so the version
-  # calculator can be used to calculate the next four-part version
+  # Parse the release version string (e.g., "1.2.3") into an AppVersion object
   release_version_current = VERSION_FORMATTER.parse(version_short)
-  # Return the formatted build code
+  # Format as four-part build code (e.g., "1.2.3.0")
   BUILD_CODE_FORMATTER.build_code(version: release_version_current)
 end