docs: update logging docs for slog-native architecture

[ankurs]

Summary

• Rewrite howto/Log.md — replace BaseLogger/SetLogger/cbslog patterns with slog-native (SetDefault, NewHandler, NewHandlerWithInner, slog.LogAttrs, AddAttrsToContext)
• Update context-aware logs examples to show both AddAttrsToContext (typed) and AddToContext (untyped)
• Update OverrideLogLevel example to use slog.LogAttrs
• Fix bug in howto/production.md: log.AddToLogContext() → log.AddToContext()
• Update Index.md feature table and package table
• Update Packages.md log package description
• Update FAQ.md: log.SetLogger() → log.SetDefault()

Test plan

• Verify Jekyll builds locally
• Check all code examples render correctly
• Verify links to pkg.go.dev still work

Ref: go-coldbrew/log#27

Summary by CodeRabbit

• Documentation
  • Revised logging docs to describe a native slog-based handler that injects per-request context fields (trace ID, RPC/HTTP info) and shows composable handler usage and examples.
  • Added guidance for adding typed and untyped log fields via new context APIs and updated example log calls and JSON output.
  • Clarified which context fields are included when sending data to error trackers.
  • Corrected FAQ guidance on the init-only configuration pattern.

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 03473d6b-af0a-4a3f-a9c0-85064743f9d3

📥 Commits

Reviewing files that changed from the base of the PR and between 9e3cb09 and 78a9069.

📒 Files selected for processing (2)

• Index.md
• howto/Log.md

✅ Files skipped from review due to trivial changes (1)

• howto/Log.md

🚧 Files skipped from review as they are similar to previous changes (1)

• Index.md

---

📝 Walkthrough

Walkthrough

Updated documentation across multiple markdown files to reflect a migration to a slog-native logging model using a custom slog.Handler, replaced log.SetLogger() references with log.SetDefault(), and documented new context APIs (log.AddAttrsToContext, log.AddToContext) plus handler composability. All edits are documentation-only.

Changes

Cohort / File(s)	Summary
Core docs & index FAQ.md, Index.md, Packages.md	Replaced references to pluggable logging/backends and log.SetLogger() with slog-native descriptions, log.SetDefault(), handler-based design, and new context APIs; updated feature/package descriptions to emphasize a custom slog.Handler that injects per-request fields.
How-to & production guidance howto/Log.md, howto/production.md	Rewrote logging how-to to show handler setup (log.SetDefault(log.NewHandler(...))), added log.NewHandlerWithInner composition examples, switched examples to slog.LogAttrs, documented log.AddAttrsToContext/log.AddToContext, and clarified which context fields are included for error trackers.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Possibly related PRs

• docs: fix sampling defaults, Log API refs, and deprecation table #52: Updates howto/Log.md to use newer context-addition APIs and slog-native guidance—directly related to these logging docs changes.
• docs: update for slog default backend and deprecations #42: Earlier documentation adjustments around switching global logger configuration from log.SetLogger to log.SetDefault and promoting slog—closely connected to this migration.

Poem

🐰 I hopped from backends old to new,
A slog-handler kissed by dew.
Context fields line up in queue,
Trace IDs and paths peek through,
Logs snug, I nibble a carrot chew. 🥕

🚥 Pre-merge checks | ✅ 3

✅ Passed checks (3 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title 'docs: update logging docs for slog-native architecture' directly and accurately describes the main change: comprehensive documentation updates reflecting a shift to slog-native logging architecture across multiple doc files.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch docs/slog-native-logging

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[coderabbitai]

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents

Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@howto/Log.md`:
- Around line 54-61: The example init function uses os.Stdout but the import
block is missing the "os" package; update the import list to include "os" so the
snippet compiles. Specifically, in the example containing func init() and
variables inner, call to slog.NewJSONHandler(os.Stdout, nil), and
log.SetDefault(log.NewHandlerWithInner(inner)), add "os" to the import block
alongside "log/slog" and "github.com/go-coldbrew/log".

🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

• Push a commit to this branch (recommended)
• Create a new PR with the fixes

---

ℹ️ Review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 00c07321-05df-4ad9-bdf4-e1ca35ef6a03

📥 Commits

Reviewing files that changed from the base of the PR and between e0e8aa6 and aafefef.

📒 Files selected for processing (5)

• FAQ.md
• Index.md
• Packages.md
• howto/Log.md
• howto/production.md

[Copilot]

Pull request overview

Updates ColdBrew documentation to reflect the newer slog-native logging architecture and APIs, replacing older logger configuration patterns and correcting outdated references.

Changes:

• Rewrites logging guidance to emphasize native slog usage (slog.LogAttrs) and the framework-provided composable slog.Handler.
• Updates docs/examples to use log.SetDefault, log.AddAttrsToContext, and log.AddToContext, including a production doc fix.
• Refreshes package/feature descriptions to describe slog-native logging behavior and context field injection.

Reviewed changes

Copilot reviewed 5 out of 5 changed files in this pull request and generated 5 comments.

Show a summary per file

File	Description
Packages.md	Updates the log package description to reflect slog-native handler-based logging and context field injection.
Index.md	Updates the “Structured Logging” feature and the log module description to describe slog-native logging.
howto/production.md	Fixes/updates logging context API references in production data handling documentation.
howto/Log.md	Rewrites the logging how-to to use slog-native APIs and updated ColdBrew logging helpers.
FAQ.md	Updates init-only configuration examples to reference log.SetDefault() instead of log.SetLogger().

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

Pull request overview

Copilot reviewed 5 out of 5 changed files in this pull request and generated 2 comments.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

Pull request overview

Copilot reviewed 5 out of 5 changed files in this pull request and generated 1 comment.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

Pull request overview

Copilot reviewed 5 out of 5 changed files in this pull request and generated 2 comments.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.