From: Jonathan Amsterdam <jba@google.com>
Date: Wed, 26 Mar 2025 15:05:29 +0000 (-0400)
Subject: log/slog: Handler doc points to handler guide
X-Git-Tag: go1.25rc1~599
X-Git-Url: http://www.git.cypherpunks.su/?a=commitdiff_plain;h=b138f8e4d2912e1105b69b9aaa24c6e8250652c6;p=gostls13.git

log/slog: Handler doc points to handler guide

There's a link in the package doc, but there should be one here too.

For #73057.

Change-Id: I8f8fe73f20bb6dd49cdf23b5f7634a92d4f7add9
Reviewed-on: https://go-review.googlesource.com/c/go/+/661015
Reviewed-by: Dmitri Shuralyov <dmitshur@google.com>
Reviewed-by: Dmitri Shuralyov <dmitshur@golang.org>
Reviewed-by: Sean Liao <sean@liao.dev>
LUCI-TryBot-Result: Go LUCI <golang-scoped@luci-project-accounts.iam.gserviceaccount.com>
---

diff --git a/src/log/slog/handler.go b/src/log/slog/handler.go
index 0451ea8fdc..66eea02aa5 100644
--- a/src/log/slog/handler.go
+++ b/src/log/slog/handler.go
@@ -28,6 +28,8 @@ import (
 //
 // Users of the slog package should not invoke Handler methods directly.
 // They should use the methods of [Logger] instead.
+//
+// Before implementing your own handler, consult https://go.dev/s/slog-handler-guide.
 type Handler interface {
 	// Enabled reports whether the handler handles records at the given level.
 	// The handler ignores records whose level is lower.