 
 (defn alter-table
   "Alters a table definition. Use it to add new
-  columns, drop existing ones, change the type of existing columns, or update the table options."
+   columns, drop existing ones, change the type of existing columns, or update the table options.
+
+   Example:
+
+   (alter-table *session* :people
+                (rename-column :naome :name)
+                (add-column :age :int))
+  "
   [^Session session & query-params]
   (cc/execute session
               (apply query/alter-table query-params)))
 
 (defn alter-keyspace
   "Alters properties of an existing keyspace. The
-  supported properties are the same that for `create-keyspace`"
+  supported properties are the same that for `create-keyspace`
+
+   Example:
+
+  (alter-keyspace *session* \"new_cql_keyspace\"
+                  (with {:durable-writes false
+                         :replication    {\"class\" \"NetworkTopologyStrategy\"
+                                          \"dc1\"   1
+                                          \"dc2\"   2}}))
+  "
   [^Session session & query-params]
   (cc/execute session
               (apply query/alter-keyspace query-params)))


  Example:

  (create-keyspace conn :new_cql_keyspace
  (with {:replication
  {:class \"SimpleStrategy\"
  :replication_factor 1}}))"
  [^Session session keyspace & query-params]
  (cc/execute session
              (apply query/create-keyspace (cons keyspace query-params))))


  Example:

  (create-table *session* :userstmp
                (column-definitions {:name        :varchar
                                     :title       :varchar
                                     :primary-key [:name]}))
  "
  [^Session session & query-params]
  (cc/execute session
              (apply query/create-table query-params)))
