diff --git a/lib/update.js b/lib/update.js
index 34e8d27..9c9f470 100644
--- a/lib/update.js
+++ b/lib/update.js
@@ -39,6 +39,10 @@ function updateArray(updates, obj) {
  * Or with a function:
  * update({ foo: x => (x + 1) }, { foo: 2 });
  * // => { foo: 3 }
+ *
+ * @param {Object|Function} updates
+ * @param {Object|Array}    object to update
+ * @return {Object|Array}   new object with modifications
  */
 function update(updates, obj) {
   if (typeof updates === 'function') {