refactor: fix doc (planning#2246)

refactor: fix doc (planning#2246)

client/src/main/java/dev/fitko/fitconnect/api/services/http/HttpClient.java

@@ -5,7 +5,7 @@ import dev.fitko.fitconnect.api.exceptions.internal.RestApiException;
 import java.util.Map;
 
 /**
- * HTTP-Service that provides basic HTTP verbs for GET, PUT and POST requests.
+ * HTTP-Service that provides basic HTTP verbs for GET, PUT, POST, PATCH, and DELETE requests.
  */
 public interface HttpClient {
 

client/src/main/java/dev/fitko/fitconnect/client/DestinationClient.java

@@ -93,7 +93,7 @@ public class DestinationClient {
      * List all self-created destinations and their configurations.
      *
      * @param offset position in the dataset
-     * @param limit  number of destinations in result-set (max. is 500)
+     * @param limit  number of destinations in a result-set (max. is 500)
      * @return {@link Destinations} object with a set of destinations
      * @throws FitConnectDestinationException if the destinations couldn't be retrieved or a technical error occurred
      */
@@ -136,7 +136,7 @@ public class DestinationClient {
      *
      * @param destinationId unique identifier of the destination
      * @param offset        position in the dataset
-     * @param limit         number of destinations in result-set (max. is 500)
+     * @param limit         number of destinations in the result-set (max. is 500)
      * @return {@link ApiJwks} list of JWKs
      * @throws FitConnectDestinationException if the keys couldn't be retrieved or a technical error occurred
      */

client/src/main/java/dev/fitko/fitconnect/client/util/DestinationValidator.java

@@ -6,6 +6,8 @@ import dev.fitko.fitconnect.api.domain.validation.ValidationResult;
 
 public class DestinationValidator {
 
+
+    // TODO should we validate any DTOs before sending them to the api ?
     public ValidationResult validateNewDestination(CreateDestination createDestination){
         return ValidationResult.ok();
     }