docs: enhance n1ql documentation

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

Author: otaviojava

jnosql-couchbase/src/main/java/org/eclipse/jnosql/databases/couchbase/mapping/N1QL.java

@@ -19,12 +19,31 @@
 import java.lang.annotation.RetentionPolicy;
 import java.lang.annotation.Target;
 
+
 /**
- * To a dynamic query on CouchbaseRepository and CouchbaseRepositoryAsync interfaces.
+ * Annotation used to define a dynamic N1QL query in {@link CouchbaseRepository}.
+ * <p>
+ * This annotation allows repository methods to be mapped to Couchbase N1QL queries.
+ * Parameters can be provided using the {@link Param} annotation.
+ * </p>
+ *
+ * <h2>Example Usage</h2>
+ * <pre>{@code
+ * @Repository
+ * interface ProductRepository extends CouchbaseRepository<Product, String> {
+ *
+ *     @N1QL("SELECT * FROM products WHERE category = $category")
+ *     List<Product> findByCategory(@Param("category") String category);
+ * }
+ * }</pre>
  */
 @Retention(RetentionPolicy.RUNTIME)
 @Target(ElementType.METHOD)
 public @interface N1QL {
-
+    /**
+     * The N1QL query string to be executed.
+     *
+     * @return the N1QL query
+     */
     String value();
 }