@@ -241,6 +241,8 @@ module Rel8
241241 , Result
242242
243243 -- * Running statements
244+ -- $running
245+
244246 -- ** @SELECT@
245247 , select
246248
@@ -362,3 +364,10 @@ import Rel8.Type.ReadShow
362364import Rel8.Type.Semigroup
363365import Rel8.Type.String
364366import Rel8.Type.Sum
367+
368+
369+-- $running
370+-- To run queries and otherwise interact with a PostgreSQL database, Rel8
371+-- provides 'select', 'insert', 'update' and 'delete' functions. Note that
372+-- 'insert', 'update' and 'delete' will generally need the
373+-- `DuplicateRecordFields` language extension enabled.