diff --git a/CHANGELOG.md b/CHANGELOG.md
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,3 +1,5 @@
+## [1.2.2](https://github.com/haskell-github-trust/effectful-config-file/compare/1.2.1...1.2.2) (2026-10-31)
+
 ## [1.2.1](https://github.com/haskell-github-trust/effectful-config-file/compare/1.2.0...1.2.1) (2026-10-31)
 
 ## [1.2.0](https://github.com/haskell-github-trust/effectful-config-file/compare/1.1.1...1.2.0) (2026-10-26)
diff --git a/effectful-config-file.cabal b/effectful-config-file.cabal
--- a/effectful-config-file.cabal
+++ b/effectful-config-file.cabal
@@ -5,7 +5,7 @@
 -- see: https://github.com/sol/hpack
 
 name:           effectful-config-file
-version:        0.1.2.1
+version:        0.1.2.2
 synopsis:       Config-file effect for effectful
 description:    Config-file parser and utilities to use in conjunction with effectful
 category:       Configuration
diff --git a/src/Effectful/Config.hs b/src/Effectful/Config.hs
--- a/src/Effectful/Config.hs
+++ b/src/Effectful/Config.hs
@@ -68,6 +68,7 @@
   => ConfigParse a
   => Show a
   => ALens' c (ConfigValue a)
+  -- ^ getter lens
   -> Eff es a
 getConfigValue lens = do
   mvar <- ask
@@ -83,8 +84,7 @@
               , "this should be impossible and is most likely a bug in your ConfigFetch instance"
               ]
 
--- | 'getConfigValue', raising t'ConfigNotFound' when an @env://@ or @file://@
--- source is absent instead of letting the 'IOException' escape.
+-- | 'getConfigValue' wrapped with 'ConfigNotFound' on missing file path
 --
 -- @since 0.1.2.0
 requireConfigValue
@@ -96,7 +96,9 @@
   => ConfigParse a
   => Show a
   => Text
+  -- ^ display name of the value
   -> ALens' c (ConfigValue a)
+  -- ^ getter lens
   -> Eff es a
 requireConfigValue name lens =
   getConfigValue lens `catch` \(_ :: IOException) -> throwError (ConfigNotFound name)
@@ -107,6 +109,7 @@
 readConfig
   :: FromValue c
   => Text
+  -- ^ contents to parse
   -> Either ConfigError c
 readConfig =
   resultToEither . decode'
@@ -125,6 +128,7 @@
   => Log :> es
   => FromValue c
   => FilePath
+  -- ^ path to read
   -> Eff es c
 readConfig' path = do
   tp <- getGlobalTracerProvider