Update documentation

pipeline/includes/web_client/web_client.h

@@ -1,21 +1,44 @@
 #ifndef BIERGARTEN_PIPELINE_WEB_CLIENT_WEB_CLIENT_H_
 #define BIERGARTEN_PIPELINE_WEB_CLIENT_WEB_CLIENT_H_
 
+/**
+ * @file web_client/web_client.h
+ * @brief Abstract interface for HTTP and URL utilities.
+ */
+
 #include <string>
 
+/**
+ * @brief Abstract web client interface.
+ */
 class WebClient {
   public:
+   /// @brief Virtual destructor for polymorphic cleanup.
    virtual ~WebClient() = default;
 
-   // Downloads content from a URL to a file. Throws on error.
+   /**
+    * @brief Downloads content from a URL into a file.
+    *
+    * @param url Source URL.
+    * @param file_path Destination file path.
+    */
    virtual void DownloadToFile(const std::string& url,
                                const std::string& file_path) = 0;
 
-   // Performs a GET request and returns the response body as a string. Throws
-   // on error.
+   /**
+    * @brief Executes an HTTP GET request.
+    *
+    * @param url Request URL.
+    * @return Response body.
+    */
    virtual std::string Get(const std::string& url) = 0;
 
-   // URL-encodes a string.
+   /**
+    * @brief URL-encodes a string value.
+    *
+    * @param value Raw string value.
+    * @return Encoded value safe for URL usage.
+    */
    virtual std::string UrlEncode(const std::string& value) = 0;
 };