[assets] Tweak JSDoc.

bookwyrm/static/js/check_all.js

@@ -1,13 +1,23 @@
-/**
- * Toggle all descendant checkboxes of a target.
- *
- * Use `data-target="ID_OF_TARGET"` on the node on which the event is listened
- * to (checkbox, button, link…), where_ID_OF_TARGET_ should be the ID of an
- * ancestor for the checkboxes.
- */
+
 (function() {
     'use strict';
 
+    /**
+     * Toggle all descendant checkboxes of a target.
+     *
+     * Use `data-target="ID_OF_TARGET"` on the node on which the event is listened
+     * to (checkbox, button, link…), where_ID_OF_TARGET_ should be the ID of an
+     * ancestor for the checkboxes.
+     *
+     * @example
+     * <input
+     *     type="checkbox"
+     *     data-action="toggle-all"
+     *     data-target="failed-imports"
+     * >
+     * @param  {Event} event
+     * @return {undefined}
+     */
     function toggleAllCheckboxes(event) {
         const mainCheckbox = event.target;