Improve documentation somewhat

Author: kjetilk

lib/utils.js

@@ -288,20 +288,28 @@ async function getQuota (root, serverUri) {
   return quota
 }
 
+/**
+ * Returns true of the user has exceeded their quota
+ */
+
 async function overQuota (root, serverUri) {
   let quota = await getQuota(root, serverUri)
   if (quota === Infinity) {
     return false
   }
-  // IMPORTANT NOTE: The following will traverse the directory to find
-  // the actual file size of the files in the file system. This is a
-  // costly operation, but neglible for the small quotas we currently
-  // allow. If the quotas grow bigger, this will significantly reduce
-  // write performance, and so it needs to be rewritten.
   var size = await actualSize(root)
   return (size > quota)
 }
 
+/**
+ * Returns the number of bytes that is occupied by the actual files in
+ * the file system. IMPORTANT NOTE: Since it traverses the directory
+ * to find the actual file sizes, this does a costly operation, but
+ * neglible for the small quotas we currently allow. If the quotas
+ * grow bigger, this will significantly reduce write performance, and
+ * so it needs to be rewritten.
+ */
+
 function actualSize (root) {
   return util.promisify(getSize)(root)
 }