Add handy comments

Author: pH-7

src/Dal/UserDal.php

@@ -58,9 +58,9 @@ public static function update(string $userUuid, UserEntity $userEntity): int|str
                 $userBean->phone = $phone;
             }
 
-            // save the user
+            // attempt to save the user
             try {
-                return R::store($userBean);
+                return R::store($userBean); // returns the user ID
             } catch (SQL $e) {
                 return false;
             } finally {