add comment

run.go

@@ -163,6 +163,9 @@ func (p *Provider) runIndividually(
 	// Run the migration outside of a transaction.
 	switch {
 	case m.IsGo():
+		// Note, we're using *sql.DB instead of *sql.Conn because it's the contract of the
+		// GoMigrationNoTx function. This may be a deadlock scenario if the caller sets max open
+		// connections to 1. See the comment in runMigrations for more details.
 		if err := m.RunNoTx(ctx, p.db, direction); err != nil {
 			return err
 		}