Add PHPDocs generated by ChatGPT,

add additional clarification to some functions,
add addNewsComment function and API, currently untested and not implemented in the client,
fix a bunch of stuff that PHPStorm pointed out

endpoints/newsarticle.php

@@ -11,6 +11,12 @@ function endpoint($endpoint_data): array
             $endpoint_data["title"],
             $endpoint_data["body"]
         ),
+        "addNewsComment" => addNewsComment(
+            $endpoint_data["user_id"],
+            $endpoint_data['news_article_id'],
+            $endpoint_data["comment_text"],
+            $endpoint_data["parent_id"]
+        ),
         default => ["Status" => "Fail", "message" => "Invalid action"],
     };
 }