MINOR: Move FileRecord JavaDoc to comment (apache#19257)

See: apache#19214 (comment)

Move explaination from Javadoc to comment.

Reviewers: Chia-Ping Tsai <[email protected]>

Author: m1a2st

clients/src/main/java/org/apache/kafka/common/record/FileRecords.java

@@ -292,19 +292,16 @@ public int writeTo(TransferableChannel destChannel, int offset, int length) thro
     /**
      * Search forward for the file position of the message batch whose last offset that is greater
      * than or equal to the target offset. If no such batch is found, return null.
-     * <p>
-     * The following logic is intentionally designed to minimize memory usage
-     * by avoiding unnecessary calls to {@link FileChannelRecordBatch#lastOffset()} for every batch.
-     * Instead, we use {@link FileChannelRecordBatch#baseOffset()} comparisons when possible, and only 
-     * check {@link FileChannelRecordBatch#lastOffset()} when absolutely necessary.
      *
      * @param targetOffset The offset to search for.
      * @param startingPosition The starting position in the file to begin searching from.
      * @return the batch's base offset, its physical position, and its size (including log overhead)
      */
     public LogOffsetPosition searchForOffsetFromPosition(long targetOffset, int startingPosition) {
         FileChannelRecordBatch prevBatch = null;
-
+        // The following logic is intentionally designed to minimize memory usage by avoiding 
+        // unnecessary calls to lastOffset() for every batch.
+        // Instead, we use baseOffset() comparisons when possible, and only check lastOffset() when absolutely necessary.
         for (FileChannelRecordBatch batch : batchesFrom(startingPosition)) {
             // If baseOffset exactly equals targetOffset, return immediately
             if (batch.baseOffset() == targetOffset) {