diff --git a/generator.go b/generator.go
index 9af04c4..129d877 100644
--- a/generator.go
+++ b/generator.go
@@ -2,7 +2,7 @@ package debefix
 
 import "io/fs"
 
-// Generate loads files and calls a resolver callback to resolve the values.
+// Generate loads files and calls a resolver callback to resolve the values, and returns the resolved data.
 // It is a combination of [Load] and [Resolve].
 func Generate(fileProvider FileProvider, resolver ResolveCallback, options ...GenerateOption) (*Data, error) {
 	return generate(func(g *generator) FileProvider {
diff --git a/resolver.go b/resolver.go
index c7c7ae4..1502f58 100644
--- a/resolver.go
+++ b/resolver.go
@@ -9,7 +9,8 @@ import (
 	"github.com/google/uuid"
 )
 
-// Resolve calls a callback for each table row, taking table dependency in account.
+// Resolve calls a callback for each table row, taking table dependency in account,
+// and returns the resolved data.
 func Resolve(data *Data, f ResolveCallback, options ...ResolveOption) (*Data, error) {
 	r := &resolver{data: data}
 	for _, opt := range options {