doc: warning for timestamp based offset querying

src/client/partition.rs

@@ -82,11 +82,6 @@ pub enum Compression {
 }
 
 /// Which type of offset should be requested by [`PartitionClient::get_offset`].
-///
-/// # Timestamp-based Queries
-/// In theory the Kafka API would also support querying an offset based on a timestamp, but the behavior seems to be
-/// semi-defined, unintuitive (even within Apache Kafka) and inconsistent between Apache Kafka and Redpanda. So we
-/// decided to NOT expose this option.
 #[derive(Debug, Clone, Copy, PartialEq, Eq)]
 pub enum OffsetAt {
     /// Earliest existing record.
@@ -99,6 +94,10 @@ pub enum OffsetAt {
     Latest,
 
     /// Timestamp
+    ///
+    /// The Kafka API supports querying an offset based on a timestamp, but the behavior seems to be
+    /// semi-defined, unintuitive (even within Apache Kafka) and inconsistent between Apache Kafka and Redpanda. Mostly it
+    /// offers timestamp based querying with millisecond precision.
     Timestamp(DateTime<Utc>),
 }