diff --git a/pyam/__init__.py b/pyam/__init__.py
index 43b9988d8..fd06a9eb8 100644
--- a/pyam/__init__.py
+++ b/pyam/__init__.py
@@ -34,5 +34,5 @@
         __version__ = version("pyam")
 
 
-# Set up logging overriding the ixmp4 logging configuration
+# Set up logging consistent with the ixmp4 "production" logging configuration
 logging.configure_logging()
diff --git a/pyam/logging.conf b/pyam/logging.conf
index 42c27212c..c90403be9 100644
--- a/pyam/logging.conf
+++ b/pyam/logging.conf
@@ -1,3 +1,4 @@
+# consistent logging with ixmp4 "production" configuration
 
 [loggers]
 keys = root,pyam_core
diff --git a/pyam/logging.py b/pyam/logging.py
index deba25864..53101a901 100644
--- a/pyam/logging.py
+++ b/pyam/logging.py
@@ -10,6 +10,7 @@
 
 
 def configure_logging():
+    """Configure logging"""
     config.fileConfig(here / "logging.conf", disable_existing_loggers=False)