docs: update documentation at arangodb

Signed-off-by: Otavio Santana <[email protected]>

Author: otaviojava

jnosql-arangodb/src/main/java/org/eclipse/jnosql/databases/arangodb/communication/ArangoDBDocumentManager.java

@@ -17,6 +17,7 @@
 import org.eclipse.jnosql.communication.document.DocumentEntity;
 import org.eclipse.jnosql.communication.document.DocumentManager;
 
+import java.util.Collections;
 import java.util.Map;
 import java.util.stream.Stream;
 
@@ -29,7 +30,7 @@ public interface ArangoDBDocumentManager extends DocumentManager {
     /**
      * Executes ArangoDB query language, AQL.
      * <p>FOR u IN users FILTER u.status == @status RETURN u </p>
-     *
+     * This conversion will happen at Eclipse JNoSQL side.
      * @param query  the query
      * @param params the named queries
      * @return the query result
@@ -40,7 +41,8 @@ public interface ArangoDBDocumentManager extends DocumentManager {
     /**
      * Executes ArangoDB query language, AQL.
      * <p>FOR u IN users FILTER u.status == @status RETURN u </p>
-     *
+     * The serialization will happen at the ArangoDB side using the {@link com.arangodb.ArangoDatabase#query(String, Class)}.
+     * This serialization will not have any converter support.
      * @param query     the query
      * @param params    named query
      * @param type The type of the result
@@ -51,7 +53,9 @@ public interface ArangoDBDocumentManager extends DocumentManager {
     <T> Stream<T> aql(String query, Map<String, Object> params, Class<T> type);
 
     /**
-     * Executes ArangoDB query language, AQL.
+     * Executes ArangoDB query language, AQL and uses the {@link Collections#emptyMap()} as params.
+     * The serialization will happen at the ArangoDB side using the {@link com.arangodb.ArangoDatabase#query(String, Class)}.
+     * This serialization will not have any converter support.
      * <p>FOR u IN users FILTER u.status == @status RETURN u </p>
      *
      * @param query     the query