feat: update javadoc

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

Author: otaviojava

jnosql-neo4j/src/main/java/org/eclipse/jnosql/databases/neo4j/communication/Neo4JDatabaseManager.java

@@ -51,11 +51,12 @@
 public interface Neo4JDatabaseManager extends DatabaseManager {
 
     /**
-     * A specialized {@link DatabaseManager
      * Executes a custom Cypher query with parameters and returns a stream of {@link CommunicationEntity}.
+     *
      * @param cypher     the Cypher query to execute.
      * @param parameters the parameters to bind to the query.
-     * @return a stream of {@link CommunicationEntity} matching the query result.
+     * @return a stream of {@link CommunicationEntity} representing the query result.
+     * @throws NullPointerException if {@code cypher} or {@code parameters} is null.
      */
     Stream<CommunicationEntity> executeQuery(String cypher, Map<String, Object> parameters);
 
@@ -66,18 +67,18 @@ public interface Neo4JDatabaseManager extends DatabaseManager {
      * @param relationship the type of relationship to traverse.
      * @param depth        the traversal depth limit.
      * @return a stream of {@link CommunicationEntity} representing related nodes.
-     * @throws NullPointerException if any of the arguments are null.
+     * @throws NullPointerException if {@code startNodeId}, {@code relationship}, or {@code depth} is null.
      */
     Stream<CommunicationEntity> traverse(String startNodeId, String relationship, int depth);
 
     /**
-     * Creates a relationship between two {@link CommunicationEntity} nodes.
+     * Creates a relationship (edge) between two {@link CommunicationEntity} nodes.
      *
      * @param source           the source entity.
      * @param target           the target entity.
      * @param relationshipType the type of relationship to create.
      * @throws EdgeCommunicationException if either the source or target entity does not exist in the database.
-     * @throws NullPointerException       if any of the arguments are null.
+     * @throws NullPointerException       if {@code source}, {@code target}, or {@code relationshipType} is null.
      */
     void edge(CommunicationEntity source, String relationshipType, CommunicationEntity target);
 
@@ -88,7 +89,7 @@ public interface Neo4JDatabaseManager extends DatabaseManager {
      * @param target           the target entity, which must already exist in the database.
      * @param relationshipType the type of relationship to remove.
      * @throws EdgeCommunicationException if either the source or target entity does not exist in the database.
-     * @throws NullPointerException       if any of the arguments are null.
+     * @throws NullPointerException       if {@code source}, {@code target}, or {@code relationshipType} is null.
      */
     void remove(CommunicationEntity source, String relationshipType, CommunicationEntity target);
 }