Add Codecov + doc improvements

.github/workflows/codecov.yaml

@@ -0,0 +1,17 @@
+name: Go
+
+on:
+  push:
+    branches: [ "main" ]
+
+jobs:
+
+  build:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v3
+
+    - name: Upload coverage reports to Codecov
+        uses: codecov/codecov-action@v3
+        env:
+            CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }}

.github/workflows/on_push.yaml → .github/workflows/main.yaml

@@ -32,4 +32,3 @@ jobs:
 
     - name: Testing
       run: make test
-

Makefile

@@ -1,15 +1,12 @@
-PACKAGES       := $(shell find . -name "*.go" | grep -v -e vendor -e bindata | xargs -n1 dirname | sort -u)
-TEST_FLAGS     := -race -count=1
-
 default: test
 
 .PHONY: lint
 lint:
-	golangci-lint run $(PACKAGES)
+	golangci-lint run ./...
 
 .PHONY: test
 test:
-	go test $(TEST_FLAGS) $(PACKAGES)
+	go test -race -count=1 ./...
 
 .PHONY: bench
 bench:

README.md

@@ -6,14 +6,24 @@
 
 Go package that provides an implementation of `log/slog`'s [Handler interface](https://pkg.go.dev/log/slog#Handler) that ensures a strong correlation between log records and [Open-Telemetry spans](https://opentelemetry.io/docs/concepts/signals/traces/#spans) by...
 
-1. Adding span and trace IDs to the log record.
-2. Adding context baggage members to the log record.
-3. Adding log record as span event.
+1. Adding [span and trace IDs](https://opentelemetry.io/docs/concepts/signals/traces/#span-context) to the log record.
+2. Adding context [baggage](https://opentelemetry.io/docs/concepts/signals/baggage/) members to the log record.
+3. Adding log record as [span event](https://opentelemetry.io/docs/concepts/signals/traces/#span-events).
 4. Adding log record attributes to the span event.
-5. Setting span status based on slog record level (only if >= slog.LevelError).
+5. Setting [span status](https://opentelemetry.io/docs/concepts/signals/traces/#span-status) based on slog record level (only if >= slog.LevelError).
 
 ## Usage
 ```go
+import (
+	"context"
+	"log/slog"
+
+	"go.opentelemetry.io/otel/baggage"
+	"go.opentelemetry.io/otel/trace"
+	sdktrace "go.opentelemetry.io/otel/sdk/trace"
+	slogotel "github.com/remychantenay/slog-otel"
+)
+
 // 1. Configure slog.
 slog.SetDefault(slog.New(slogotel.OtelHandler{
 	Next: slog.NewJSONHandler(os.Stdout, nil),
@@ -23,11 +33,17 @@ slog.SetDefault(slog.New(slogotel.OtelHandler{
 logger := slog.Default()
 logger = logger.With("component", "server")
 
-// 3. Start your span.
+// 3. (Optional) Add baggage to your context.
+m1, _ := baggage.NewMember("key_1", "value_1")
+m2, _ := baggage.NewMember("key_2", "value_2")
+bag, _ := baggage.New(m1, m2)
+ctx := baggage.ContextWithBaggage(context.Background(), bag)
+
+// 4. Start your span.
 ctx, span := tracer.Start(ctx, "operation-name")
 defer span.End()
 
-// 4. Log
+// 5. Log.
 logger.InfoContext(ctx, "Hello world!", "locale", "en_US")
 ```
 

doc.go

@@ -3,16 +3,37 @@ Package slogotel provides a custom handler for `log/slog` to ensures strong corr
 
 # Usage
 
+	import (
+		"context"
+		"log/slog"
+
+		"go.opentelemetry.io/otel/baggage"
+		"go.opentelemetry.io/otel/trace"
+		sdktrace "go.opentelemetry.io/otel/sdk/trace"
+		slogotel "github.com/remychantenay/slog-otel"
+	)
+
+	// 1. Configure slog.
 	slog.SetDefault(slog.New(slogotel.OtelHandler{
 		Next: slog.NewJSONHandler(os.Stdout, nil),
 	}))
 
+	// 2. Set up your logger.
 	logger := slog.Default()
 	logger = logger.With("component", "server")
 
+	// 3. (Optional) Add baggage to your context.
+	m1, _ := baggage.NewMember("key_1", "value_1")
+	m2, _ := baggage.NewMember("key_2", "value_2")
+	bag, _ := baggage.New(m1, m2)
+	ctx := baggage.ContextWithBaggage(context.Background(), bag)
+
+	// 4. Start your span.
+	tracer := sdktrace.NewTracerProvider().Tracer("server")
 	ctx, span := tracer.Start(ctx, "operation-name")
 	defer span.End()
 
+	// 5. Log.
 	logger.InfoContext(ctx, "Hello world!", "locale", "en_US")
 */
 package slogotel