 ;;
 
 (defn insert
-  "Executes the `INSERT` statement, which writes one or more columns for a given row in a table.
-   Note that since a row is identified by its PRIMARY KEY, the columns that compose it must be
+  "Inserts a row in a table.
+
+   Note that since a row is identified by its primary key, the columns that compose it must be
    specified. Also, since a row only exists when it contains one value for a column not part of
-   the PRIMARY KEY, one such value must be specified too."
+   the primary key, one such value must be specified too."
   [^Session session & query-params]
   (execute- session query-params query/insert-query))
 
 (defn insert-batch
-  "Executes batch of `INSERT` queries."
+  "Performs a batch insert (inserts multiple records into a table at the same time)"
   [^Session session table records]
   (->> (map #(query/insert-query table %) records)
        (apply query/queries)

  (execute- session [ks] query/drop-keyspace-query))

(defn create-keyspace
  "Executes `CREATE KEYSPACE` statement, which creates a new top-level keyspace. A keyspace is a namespace that
   defines a replication strategy and some options for a set of tables.

   Example:


  (execute- session query-params query/create-keyspace-query))

(defn create-index
  "Creates a new (automatic) secondary index for a given (existing)
   column in a given table.If data already exists for the column, it will be indexed during the execution
   of this statement. After the index is created, new data for the column is indexed automatically at
   insertion time.
