diff --git a/core/core-projects.el b/core/core-projects.el
index 75b7ff91a..7a664bcc9 100644
--- a/core/core-projects.el
+++ b/core/core-projects.el
@@ -68,16 +68,16 @@ you want to interactive with a project other than the one you're in."
     (remhash (format "%s-%s" fn default-directory) projectile-project-root-cache)))
 
 (defun doom-project-p (&optional nocache)
-  "Whether or not this buffer is currently in a project or not."
+  "Return t if this buffer is currently in a project.
+If NOCACHE, don't fetch a cached answer."
   (if nocache
       (without-project-cache! (doom-project-p nil))
     (let ((projectile-require-project-root t))
       (projectile-project-p))))
 
 (defun doom-project-root (&optional nocache)
-  "Get the path to the root of your project.
-If STRICT-P, return nil if no project was found, otherwise return
-`default-directory'."
+  "Returns the root of your project, or `default-directory' if none was found.
+If NOCACHE, don't fetch a cached answer."
   (if nocache
       (without-project-cache! (doom-project-root nil))
     (let (projectile-require-project-root)