docs: create couchbase repository

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

Author: otaviojava

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

@@ -18,9 +18,27 @@
 import org.eclipse.jnosql.mapping.NoSQLRepository;
 
 /**
- * The couchbase {@link NoSQLRepository}
+ * A Couchbase-specific extension of {@link NoSQLRepository}.
+ * <p>
+ * This repository interface provides built-in CRUD operations and supports dynamic queries
+ * using the {@link N1QL} annotation for executing Couchbase N1QL queries.
+ * </p>
+ *
+ * <h2>Example Usage</h2>
+ * <pre>{@code
+ * @Repository
+ * interface UserRepository extends CouchbaseRepository<User, String> {
+ *
+ *     @N1QL("SELECT * FROM users WHERE name = $name")
+ *     List<User> findByName(@Param("name") String name);
+ *
+ *     @N1QL("SELECT * FROM users WHERE age > $age")
+ *     List<User> findByAgeGreaterThan(@Param("age") int age);
+ * }
+ * }</pre>
+ *
  * @param <T> the entity type
- * @param <K> the entity id type
+ * @param <K> the entity ID type
  */
 public interface CouchbaseRepository<T, K> extends NoSQLRepository<T, K> {
 }