diff --git a/src/app/config/app_config.dox b/src/app/config/app_config.dox
index d0d2ee3637..ef4a878277 100644
--- a/src/app/config/app_config.dox
+++ b/src/app/config/app_config.dox
@@ -1,4 +1,8 @@
 /**
 @dir /app/config
-@brief app/config
+@brief app/config: Top-level configuration code
+
+Refactoring this module is a work in progress, see
+[ticket 29211](https://trac.torproject.org/projects/tor/ticket/29211).
+
 **/
diff --git a/src/app/main/app_main.dox b/src/app/main/app_main.dox
index 3da20226d3..c714ad1396 100644
--- a/src/app/main/app_main.dox
+++ b/src/app/main/app_main.dox
@@ -1,4 +1,4 @@
 /**
 @dir /app/main
-@brief app/main
+@brief app/main: Entry point for tor.
 **/