diff --git a/src/log/slog/doc.go b/src/log/slog/doc.go index 001559326b..cc034ca4b9 100644 --- a/src/log/slog/doc.go +++ b/src/log/slog/doc.go @@ -310,8 +310,10 @@ Then use a value of that type in log calls: Now computeExpensiveValue will only be called when the line is enabled. The built-in handlers acquire a lock before calling [io.Writer.Write] -to ensure that each record is written in one piece. User-defined -handlers are responsible for their own locking. +to ensure that exactly one [Record] is written at a time in its entirety. +Although each log record has a timestamp, +the built-in handlers do not use that time to sort the written records. +User-defined handlers are responsible for their own locking and sorting. # Writing a handler