M-x checkdoc.

quse-package.el

@@ -9,15 +9,21 @@
 ;; Homepage: github.com/jaccarmac/quse-package
 ;; Package-Requires: ((quelpa "0") (use-package "0"))
 
+;;; Commentary:
+;; Use this package exactly like you would use-package, with the exception that
+;; the package name should be a quelpa recipe.  If the first argument after the
+;; recipe is :upgrade, it will be treated as an :upgrade argument to quelpa.
+
 ;;; Code:
 
 ;;;###autoload
 (defmacro quse-package (quelpa-form &rest use-package-forms)
-  "Download a package with quelpa and initialize it with use-package.
-quelpa-form should be an *unquoted* name or list compatible with quelpa.
-use-package-form should be whatever comes after the package name in a
-use-package call. If the first element of use-package-form is :upgrade, the
-next element is used as the :upgrade parameter to the quelpa call."
+  "Download a package with quelpa and initialize it with ‘use-package’.
+QUELPA-FORM should be an *unquoted* name or list compatible with
+quelpa.  USE-PACKAGE-FORMS should be whatever comes after the
+package name in a ‘use-package’ call.  If the first element of
+USE-PACKAGE-FORMS is :upgrade, the next element is used as
+the :upgrade parameter to the quelpa call."
   (let* ((upgrade-form (if (and use-package-forms
                                 (eq :upgrade (car use-package-forms)))
                            (list (car use-package-forms)

quse-package.org

@@ -76,6 +76,11 @@ Without further ado, the macro itself.
     ;; Homepage: github.com/jaccarmac/quse-package
     ;; Package-Requires: ((quelpa "0") (use-package "0"))
 
+    ;;; Commentary:
+    ;; Use this package exactly like you would use-package, with the exception that
+    ;; the package name should be a quelpa recipe.  If the first argument after the
+    ;; recipe is :upgrade, it will be treated as an :upgrade argument to quelpa.
+
     ;;; Code:
   #+END_SRC
 
@@ -105,11 +110,12 @@ Without further ado, the macro itself.
   #+BEGIN_SRC emacs-lisp
     ;;;###autoload
     (defmacro quse-package (quelpa-form &rest use-package-forms)
-      "Download a package with quelpa and initialize it with use-package.
-    quelpa-form should be an *unquoted* name or list compatible with quelpa.
-    use-package-form should be whatever comes after the package name in a
-    use-package call. If the first element of use-package-form is :upgrade, the
-    next element is used as the :upgrade parameter to the quelpa call."
+      "Download a package with quelpa and initialize it with ‘use-package’.
+    QUELPA-FORM should be an *unquoted* name or list compatible with
+    quelpa.  USE-PACKAGE-FORMS should be whatever comes after the
+    package name in a ‘use-package’ call.  If the first element of
+    USE-PACKAGE-FORMS is :upgrade, the next element is used as
+    the :upgrade parameter to the quelpa call."
       (let* ((upgrade-form (if (and use-package-forms
                                     (eq :upgrade (car use-package-forms)))
                                (list (car use-package-forms)