docs(migrate): require Goose migration authoring tools

migrate/migrate.go

@@ -24,9 +24,9 @@ import (
 // affinity (transaction-pooling proxies cannot safely hold session locks).
 //
 // Use the returned Provider's Up, UpTo, DownTo, Status, GetDBVersion, GetVersions,
-// and HasPending methods directly. Filenames must sort lexically in numeric
-// version order: use zero-padded sequential or fixed-width timestamp prefixes,
-// as produced by Goose's migration creator. Global Go registration is ignored.
+// and HasPending methods directly. Create migration files with Goose's create
+// command; lexical filename order must match numeric version order. Go migrations
+// are registered per provider; global Go registration is ignored.
 func New(db *sql.DB, dialect goose.Dialect, files embed.FS, dir string, logger *slog.Logger, migrations ...*goose.Migration) (*goose.Provider, error) {
 	for i, migration := range migrations {
 		if migration == nil {