diff --git a/src/app/config/app_config.dox b/src/app/config/app_config.dox
index d0d2ee3637090ccd00a4505224172d66d6daa33b..ef4a8782773554a4c982715ba610a28b928033bf 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 3da20226d35b4afe0a904dd3b9b5a201933eb4ce..c714ad1396c2f5e9412f38c74fd0063f8cab6b11 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.
 **/