From 5bce932d6942dc65c821a19abb69e8816746a985 Mon Sep 17 00:00:00 2001
From: Maximillian Arruda <dearrudam@gmail.com>
Date: Mon, 12 Jun 2023 09:02:10 -0300
Subject: [PATCH] docs: enhance `ColumnTemplate` javadoc

Signed-off-by: Maximillian Arruda <dearrudam@gmail.com>
---
 .../jakarta/nosql/column/ColumnTemplate.java  | 20 +++++++++++++++----
 1 file changed, 16 insertions(+), 4 deletions(-)

diff --git a/api/nosql-column/src/main/java/jakarta/nosql/column/ColumnTemplate.java b/api/nosql-column/src/main/java/jakarta/nosql/column/ColumnTemplate.java
index 0c242ca33..4fbb8504d 100644
--- a/api/nosql-column/src/main/java/jakarta/nosql/column/ColumnTemplate.java
+++ b/api/nosql-column/src/main/java/jakarta/nosql/column/ColumnTemplate.java
@@ -23,11 +23,14 @@
 import java.util.stream.Stream;
 
 /**
- * The <b>ColumnTemplate</b> class is a type of <b>Template</b> that makes it easier to work with Column-Family
- * or Wide-Column databases. These NoSQL databases store data in a table-like structure,
+ * It's a {@link Template} specialization for Column-Family or Wide-Column databases.
+ *
+ * <p>
+ * These NoSQL databases store data in a table-like structure,
  * where each column contains a particular attribute or piece of information.
- * The query syntax belongs to each provider; thus, it is not Jakarta's NoSQL scope to define it.
- * Accordingly, it might vary from implementation and NoSQL provider.
+ *
+ * <p>
+ * This interface provides some methods that accepts queries in a text format to retrieve from the database but, <b>the query syntax belongs to each provider, thus, it is not Jakarta's NoSQL scope to define it. Accordingly, it might vary from implementation and NoSQL provider.</b>
  */
 public interface ColumnTemplate extends Template {
 
@@ -56,6 +59,9 @@ public interface ColumnTemplate extends Template {
     /**
      * Executes a native query database then bring the result as a {@link Stream}
      *
+     * <p>
+     * <b>the query syntax belongs to each provider, thus, it is not Jakarta's NoSQL scope to define it. Accordingly, it might vary from implementation and NoSQL provider.</b>
+     *
      * @param query the query
      * @param <T>   the entity type
      * @return the result as {@link Stream}
@@ -67,6 +73,9 @@ public interface ColumnTemplate extends Template {
     /**
      * Executes a query then bring the result as a unique result
      *
+     * <p>
+     * <b>the query syntax belongs to each provider, thus, it is not Jakarta's NoSQL scope to define it. Accordingly, it might vary from implementation and NoSQL provider.</b>
+     *
      * @param query the query
      * @param <T>   the entity type
      * @return the result as {@link Optional}
@@ -78,6 +87,9 @@ public interface ColumnTemplate extends Template {
     /**
      * Creates a {@link PreparedStatement} from the query
      *
+     * <p>
+     * <b>the query syntax belongs to each provider, thus, it is not Jakarta's NoSQL scope to define it. Accordingly, it might vary from implementation and NoSQL provider.</b>
+     *
      * @param query the query
      * @return a {@link PreparedStatement} instance
      * @throws NullPointerException          when the query is null