           (package--print-help-section "Modules")
           (insert "Declared by the following Doom modules:\n")
           (dolist (m modules)
-            (insert indent)
-            (doom--help-package-insert-button
-              (format "%s %s" (car m) (or (cdr m) ""))
-              (pcase (car m)
-                (:core doom-core-dir)
-                (:private doom-private-dir)
-                (category (doom-module-path category (cdr m)))))
-            (insert "\n")))
+            (let* ((module-path (pcase (car m)
+                                  (:core doom-core-dir)
+                                  (:private doom-private-dir)
+                                  (category (doom-module-path category (cdr m)))))
+                   (readme-path (expand-file-name "README.org" module-path)))
+              (insert indent)
+              (doom--help-insert-button
+               (format "%s %s" (car m) (or (cdr m) ""))
+               module-path)
+              (insert " (")
+              (if (file-exists-p readme-path)
+                  (doom--help-insert-button
+                   "readme"
+                   (expand-file-name
+                    "README.org"
+                    readme-path))
+                (insert "no readme"))
+              (insert ")\n"))))
 
         (package--print-help-section "Configs")
         (insert "This package is configured in the following locations:")

           ":(exclude)*.org"))
     "\n" t)))

;;;###autoload
(defun doom/help-packages (package)
  "Like `describe-package', but for packages installed by Doom modules.

                                     (format "%s.el" package))))
                  (_ (plist-get plist :url))))))
        ((and (require 'package nil t)
              (or package-archive-contents
                  (progn (package-refresh-contents)
                         package-archive-contents))
              (pcase (package-desc-archive (cadr (assq package package-archive-contents)))
                ("org" "https://orgmode.org")
                ((or "melpa" "melpa-mirror")
